mcp: Instructions file for Claude Code

Using the FourA MCP with Claude

Setup notes specific to Claude Desktop, Claude Code, and the Claude API. For the full tool and prompt reference see README.md and AGENTS.md.

Claude Code

export FOURA_API_KEY=pk_live_...
claude mcp add foura -- npx -y @fouradata/mcp

Or connect to the hosted endpoint (Streamable HTTP):

claude mcp add --transport http foura https://mcp.foura.ai/mcp --header "Authorization: Bearer pk_live_..."

Claude Desktop

Add this to claude_desktop_config.json (Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "foura": {
      "command": "npx",
      "args": ["-y", "@fouradata/mcp"],
      "env": { "FOURA_API_KEY": "pk_live_..." }
    }
  }
}

Gotcha: fully quit Claude Desktop (Cmd+Q on macOS) before editing the config. If it is still running, it overwrites your edits with its in-memory config on exit. Use the stdio config above for Claude Desktop; remote transport support varies by client version.

offload_large requires a client that can read MCP resource_link blocks. Leave it at the default false if your client doesn't support them.

What you get

Four tools (foura_auto, foura_single, foura_proxy, foura_browser) and six prompts under /prompts. All tools are read-only, so Claude clients that auto-approve trusted read-only tools call them without a per-request confirmation prompt. Start with foura_auto - give it a URL and it returns the page, choosing the fetch method for you.

---

FourA: https://foura.ai | MCP server: https://foura.ai/mcp | Docs: https://foura.ai/docs/mcp/server