Fous documentation

Build with your coding agent

Copy one prompt that points Claude Code, Codex, Cursor or any agent at these docs, or copy the MCP install line for your client. Every page here is also Markdown.

Copy prompt

Claude CodeCodexCursorVS Code

Your first call

A tool is a website task with a typed input and output. Name the tool, its operation and the input, and Fous runs it and returns the data. This call reads the Hacker News front page; it needs an API key and nothing else.

$curl 'https://api.fous.com/v1/query' \
>  -H "Authorization: Bearer $FOUS_API_KEY" \
>  -H "Idempotency-Key: $FOUS_IDEMPOTENCY_KEY" \
>  -H 'Content-Type: application/json' \
>  -d '{"api":"@hacker-news","operation":"list_front_page","input":{"list_name":"show_hn","max_results":5}}'

The response carries the output and a receipt. Each completed run costs 1 credit; finding tools and checking status is free.

{
  "success": true,
  "data": {
    "output": {
      "stories": [
        {
          "rank": 1,
          "title": "Show HN: Jeff – Jev-compatible 0.8B decision models, trained at home",
          "author": "firelex",
          "points": 230,
          "comment_count": 79,
          "discussion_link": "https://news.ycombinator.com/item?id=49883844"
        }
      ]
    },
    "receipt": {
      "request_id": "req_mg7x9f2kQ1nTz8bW3pLc0RhV",
      "api": "@hacker-news",
      "operation": "list_front_page",
      "billing": { "status": "settled", "reserved_credits": 1, "charged_credits": 1 }
    }
  }
}

How it fits together

1. Find a tool. Search the catalog of public tools, or build your own in Studio from a website and a description. Every operation publishes an input schema, an output schema and verified examples.
2. Call it. POST /v1/query with api, operation and input. Pin a contract version when your integration depends on one. Call a tool.
3. Use the result. Read data.output, keep data.receipt.request_id, and send an Idempotency-Key so a retry never pays twice. Retries and idempotency.

For AI agents

Claude, Codex, Cursor, VS Code and any MCP client connect to the Fous MCP server to find tools, read their contracts, run them and check results. Credentials with the required scopes can also build tools, connect accounts and save service keys. fous_status shows the connected organization, credits and remaining free builds. Connect an AI agent.

Every page of these docs is also Markdown. Add .md to any URL, or start from llms.txt. Use with coding agents.