Connect your AI agent
Live website data in Claude, Codex, Cursor, and any MCP client.
Connect your client
Fous uses Streamable HTTP. Add the server below and sign in with the Fous organization you want to use. If OAuth is unavailable for your environment, use the API-key option in a client that supports bearer headers.
In Claude, open Settings → Connectors → Add custom connector. Name it Fous, paste this URL, and connect with your Fous account. Custom connectors depend on your plan and workspace permissions.
https://api.fous.com/mcp
Add Fous to your user configuration, then run /mcp in Claude Code to sign in.
claude mcp add --scope user --transport http fous https://api.fous.com/mcp
Use an API key instead
Set FOUS_API_KEY in your shell first.
claude mcp add --scope user --transport http fous https://api.fous.com/mcp \
--header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY first}"
Add Fous and sign in with your Fous account. Codex shares this configuration across its CLI and IDE extension.
codex mcp add fous --url https://api.fous.com/mcp
codex mcp login fous
Use an API key instead
With FOUS_API_KEY set in the environment that launches Codex:
# ~/.codex/config.toml
[mcp_servers.fous]
url = "https://api.fous.com/mcp"
bearer_token_env_var = "FOUS_API_KEY"
tool_timeout_sec = 180
Add this to ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project. Connect Fous in Cursor's MCP settings and complete sign-in.
{
"mcpServers": {
"fous": {
"url": "https://api.fous.com/mcp"
}
}
}
Use an API key instead
Make FOUS_API_KEY available to Cursor, then add an authorization header:
{
"mcpServers": {
"fous": {
"url": "https://api.fous.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FOUS_API_KEY}"
}
}
}
}
Add this to .vscode/mcp.json. Start the server from the editor, then follow the Fous sign-in prompt.
{
"servers": {
"fous": {
"type": "http",
"url": "https://api.fous.com/mcp"
}
}
}
Use an API key instead
VS Code can prompt for your key without saving it in the project file:
{
"inputs": [
{
"type": "promptString",
"id": "fous-api-key",
"description": "Fous API key",
"password": true
}
],
"servers": {
"fous": {
"type": "http",
"url": "https://api.fous.com/mcp",
"headers": {
"Authorization": "Bearer ${input:fous-api-key}"
}
}
}
}
Use your workspace's custom MCP app or plugin setup to add Fous with this server URL and OAuth authentication. Sign in to Fous and select your organization. Custom app availability depends on your ChatGPT plan and administrator settings.
https://api.fous.com/mcp
Make a first request
Once connected, ask your agent for data in plain words. For example:
Find five pizza places in Austin rated 4.5 or higher, with their phone numbers.
The agent uses fous_query to find workflows and run them. A match must exist in the public catalog or your organization's private workflows.
Available tools
| Tool | Purpose |
|---|---|
fous_query | Find and run workflows from a plain-language request |
fous_search_workflows | Search available workflows |
fous_get_workflow | Read a workflow's operations and schemas |
fous_run_workflow | Run a read operation with exact inputs |
fous_run_action | Run an explicitly requested website action |
fous_get_run | Check an existing run without repeating it |
Search, inspection, routing, and status checks are free. A completed workflow run uses 1 credit. A prompt can invoke more than one workflow.
Read-only or one-workflow connections
To exclude tools that change websites, connect to:
https://api.fous.com/mcp?read_only=true
To expose one workflow, use its handle without @ in the path. This illustrative URL exposes that workflow's operations and fous_get_run:
https://api.fous.com/mcp/workflows/example_weather
You can add ?read_only=true to a workflow-specific URL too. Access still follows the connected organization's permissions.
Longer runs and output size
Calls wait up to wait_seconds before returning: 50 seconds by default, configurable from 1–170. A result with status: running includes a request_id. Pass it to fous_get_run; do not submit the operation again to check progress.
max_chars limits returned JSON characters: 20,000 by default, from 1,000–150,000. Larger results are shortened. For direct runs, use include or exclude to select the fields you need.
Retained terminal results are available for 24 hours. Read about receipts and request status.
Website actions
fous_query only looks up data. Operations that change a website use fous_run_action and the organization's connected account. Confirm the intended action and details in your client before running it.
Cancelling after an action has been sent to a website may be too late to stop it. Use its request ID to check status before trying again.