[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_121":122},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":48,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":48,"_82":-5,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94},"apiUrl","https://odel.app/api","creator","fouradata","moduleId","mcp","@fouradata/mcp","displayName","tagline","Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.","iconKey","https://avatars.githubusercontent.com/u/298563228?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.foura.ai/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783311580000,"updatedAt",1788754798000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.foura%2Fmcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",4,"upstreamUpdatedAt",1788405017000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/fouradata/mcp","githubRepoFullName","fouradata/mcp","releaseId","ext-fouradata-mcp","version","0.6.0","descriptionMarkdown","\n

\n $\"FourA\"$ \n

\n\n

FourA MCP

\n\n

Reliable web access for AI agents.

\n\n

\n Give your agent a public URL. FourA returns the content, whether the page needs a fast HTTP request,\n proxy rotation, or a full browser session.\n

\n\n

\n $\"npm$ \n $\"npm$ \n $\"MIT$ \n $\"FourA$ \n $\"FourA$ \n

\n\nStart with `foura_auto`: one URL in, typed content out. It chooses the appropriate fetch method and handles common blocks for you. Use `foura_single`, `foura_proxy`, or `foura_browser` when you want explicit control over the request path.\n\n| Start simple | Reach difficult pages | Build predictable agent flows |\n|---|---|---|\n| One default tool for most URLs | HTTP, proxy rotation, and full-browser rendering | Typed outputs, stable error codes, and six ready-made prompts |\n\nThe included workflows cover product extraction, article cleanup, price monitoring, endpoint checks, and bulk URL fetching.\n\nUse it from Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, or any MCP client. Run the npm package locally or connect to the hosted Streamable HTTP endpoint with the same FourA API key.\n\n**[Get an API key](https://foura.ai/dashboard/#api-keys) | [Read the MCP docs](https://foura.ai/docs/mcp/server) | [See the package on npm](https://www.npmjs.com/package/@fouradata/mcp)**\n\n**One-click install:**\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=foura&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBmb3VyYWRhdGEvbWNwIl0sImVudiI6eyJGT1VSQV9BUElfS0VZIjoiWU9VUl9GT1VSQV9BUElfS0VZIn19)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522foura%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540fouradata%252Fmcp%2522%255D%252C%2522env%2522%253A%257B%2522FOURA_API_KEY%2522%253A%2522YOUR_FOURA_API_KEY%2522%257D%257D)\n\nBoth buttons pre-fill the config with a `YOUR_FOURA_API_KEY` placeholder - replace it with your key. Or by hand: `claude mcp add foura -- npx -y @fouradata/mcp` (set `FOURA_API_KEY` in env first). Full per-client setup below.\n\n## Quick Start - local stdio (recommended for Claude Desktop)\n\nCreate or reveal an API key at [foura.ai/dashboard/#api-keys](https://foura.ai/dashboard/#api-keys) (format `pk_live_...`). Then drop this into your MCP client's config:\n\n```json\n{\n \"mcpServers\": {\n \"foura\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@fouradata/mcp\"],\n \"env\": {\n \"FOURA_API_KEY\": \"pk_live_...\"\n }\n }\n }\n}\n```\n\n> **Claude Desktop gotcha:** fully quit Claude Desktop (`Cmd+Q` on macOS) **before** editing the config file. If the app is still running, it will overwrite your edits with its in-memory config on exit.\n\nThe npx command downloads the package on first launch and runs it as a subprocess of your MCP client. No global install needed. The same JSON works across MCP clients; only the config-file location changes:\n\n| Client | Where the config lives |\n|---|---|\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Claude Code | `claude mcp add foura -- npx -y @fouradata/mcp` (set `FOURA_API_KEY` in env first) |\n| Cursor | `~/.cursor/mcp.json` |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` |\n| VS Code (MCP extension) | `.vscode/mcp.json` in your workspace |\n\nRestart the client and `foura_auto`, `foura_single`, `foura_proxy`, `foura_browser` show up in your tool list, plus six prompts under `/prompts`.\n\n## Quick Start - hosted (Streamable HTTP)\n\nIf your client supports the Streamable HTTP transport, point it at the hosted endpoint instead of running a local subprocess:\n\n```json\n{\n \"mcpServers\": {\n \"foura\": {\n \"url\": \"https://mcp.foura.ai/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer pk_live_...\"\n }\n }\n }\n}\n```\n\nFor Claude Desktop, use the stdio config above. You can also bridge the hosted endpoint through `mcp-remote`:\n\n```json\n{\n \"mcpServers\": {\n \"foura\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.foura.ai/mcp\", \"--header\", \"Authorization: Bearer pk_live_...\"]\n }\n }\n}\n```\n\n## The Tools\n\n`foura_auto` is the **default** - give it a URL and it returns the content, choosing the fetch method for you. The other three tools give you direct control over HTTP, proxy rotation, and browser rendering.\n\nAll four are marked `readOnlyHint: true` and `openWorldHint: true` per the [MCP specification](https://modelcontextprotocol.io/specification). Clients can use those annotations when deciding how to present or approve tool calls.\n\nEvery response carries human-readable text (`content`) plus a typed `structuredContent` JSON object validated against the tool's `outputSchema`. Your agent gets a predictable response contract instead of parsing prose.\n\n### `foura_auto` - smart fetch (the default)\n\nGive it a URL and get the content back. Use this first when you don't want to choose between HTTP, proxy rotation, and browser rendering. It handles common bot challenges and keeps the client surface small, with no proxy-attempt tuning required.\n\n```jsonc\n{\n \"url\": \"https://example.com\",\n // optional: a substring the real page must contain, so auto can tell a\n // real page from a challenge page on protected targets\n \"validate\": { \"data\": { \"accept\": [\"Example Domain\"] } }\n}\n```\n\nThe client surface is intentionally minimal: `url` (required), plus optional `method`, `headers`, `data`, `validate`, `returnSession` (default `true`), `forceProxy` (default `true`), `timeout_ms` (5000-180000, default 120000), `ignoreProxies`.\n\n`structuredContent` shape: `{status, headers, data, meta, session}`. `meta` is always present - `{rung, solved, attempts, credits}` - so your agent can see how the request completed and how many credits it used. `session` (`{proxy, cookies, userAgent}`) is returned by default for follow-up requests (pass `session.proxy` into the `proxy` field). Send `returnSession: false` to omit it. There is no `total_time` field on auto.\n\n### `foura_single` - fast HTTP\n\nOne HTTP request, response back. Use it for static pages, JSON APIs, and server-rendered HTML. `unblocker` defaults to `true`, so the request already carries a full browser header set; set it to `false` for a plain HTTP request.\n\n```jsonc\n{\n \"method\": \"GET\",\n \"url\": \"https://example.com\"\n}\n```\n\nSupports custom headers, a body, per-stage timeouts, redirect controls, JSON auto-parse, a binary-buffer mode, and built-in response validation (`validate.status.accept`, `validate.data.fail`, and so on). If `foura_single` comes back blocked - status 403/429, a captcha page, challenge response headers, or a known challenge title - try a different browser profile (below), then escalate to `foura_proxy`. Start with `maxTries: 5`; protected targets may need `25-30`. If the page also needs JavaScript to render, pass `foura_proxy`'s returned `proxy` ID to `foura_browser.proxy`.\n\n`structuredContent` shape: `{status, headers, data, total_time, ...}`. When the target ran a bot check, the response also carries `defense`; `defense.solved: false` means the body may be a challenge page rather than the content you asked for.\n\n#### Choosing which browser you present\n\nBy default a request presents the latest Google Chrome. Some targets accept one browser and refuse another, so `foura_single` and `foura_proxy` let you pick:\n\n```jsonc\n{\n \"method\": \"GET\",\n \"url\": \"https://example.com\",\n \"browser\": \"Firefox\",\n \"os\": \"Windows\"\n}\n```\n\n- `browser` - `Chrome`, `Edge`, `Safari`, `Firefox`, or `Tor`.\n- `os` - `Windows`, `macOS`, `Android`, or `iOS`. A family name accepts any of its versions; the exact labels in the catalogue narrow further.\n- `version` - any version the catalogue lists for that browser. The newest match wins when several fit.\n- `profile` - an exact id from the catalogue, when you already have one.\n\nThe full catalogue is public at [api.foura.ai/api/profiles](https://api.foura.ai/api/profiles), no key required, and its `default` field names the profile a request gets when you ask for nothing. Selection needs `unblocker` on, which is the default. A combination that does not exist returns an error listing what is available, so a request is never quietly sent as a browser you did not choose.\n\n### `foura_proxy` - rotating proxies with retry\n\nSame target shape as `foura_single`, but routed through rotating proxies with automatic retry on failure. Use it when a direct request is blocked or when the target requires a specific exit country.\n\n```jsonc\n{\n \"maxTries\": 5,\n \"exitCountries\": [\"CZ\", \"GB\"],\n \"request\": {\n \"method\": \"GET\",\n \"url\": \"https://example.com/pricing\",\n \"browser\": \"Chrome\",\n \"os\": \"Windows\"\n }\n}\n```\n\n`structuredContent` adds `proxy` (the encoded ID of the proxy that succeeded) and `total` (outer timing including selection and retries). `exitCountries` is optional: values are trimmed, uppercased, and deduplicated; proxies with unknown exits are excluded; the request never falls back to an unrequested country. Selection uses the latest available country metadata, normally updated within ten minutes, and a scoped success returns that value as `exitCountry`. If no eligible proxy matches, the result uses `code: \"no_eligible_proxy\"`.\n\nThe inner `request` takes the same browser-profile fields as `foura_single`: `browser`, `os`, `version`, or an exact `profile`.\n\nFor difficult WAF challenges, use `maxTries: 25-30`. For a country allowlist, set `exitCountries` instead of increasing attempts. If the target needs JavaScript rendering, pass the returned `proxy` ID to `foura_browser.proxy`.\n\n### `foura_browser` - full browser session\n\nA real browser session. JavaScript runs, the DOM finishes rendering, cookies come back with the response. Use it when the page is a single-page app, when content lazy-loads after first paint, or when there's an anti-bot challenge that needs a real browser to clear.\n\n```jsonc\n{\n \"url\": \"https://example.com/spa\",\n \"timeout_ms\": 15000,\n \"checkText\": \"data-table\"\n}\n```\n\nUse this when an HTTP response isn't enough. `checkText` validates the rendered HTML once navigation completes; it doesn't wait or poll. If the substring is missing, the call fails with an error envelope. This catches pages that return 200 without the content you need. `unblocker` defaults to `true` and handles supported anti-bot or captcha challenges along the way. Set it to `false` to return the page exactly as it loads, challenge included.\n\n`structuredContent` shape is intentionally different from single/proxy: `{status, headers (object, not array), body (not data), cookies (full browser cookie shape), userAgent}`.\n\n## Built-in Prompts\n\nSix workflow templates surfaced under `/prompts` in your MCP client. They orchestrate one or more tools without you spelling out the steps.\n\n| Prompt | Arguments | What it does |\n|---|---|---|\n| `smart_fetch` | `url, must_contain?, extract?` | Pick the method, handle bot protection, and return or extract content |\n| `scrape_product_page` | `url` | Extract title, price, image, stock, and SKU as JSON in a browser session |\n| `extract_article` | `url` | Fetch an article, retry through a proxy if needed, and remove page chrome |\n| `monitor_pricing` | `url, target_price?` | Fetch the current price and compare it with a target |\n| `check_endpoint_health` | `url, expected_text?` | Validate reachability, status, content, and timing |\n| `bulk_fetch_urls` | `urls` (comma-separated) | Fetch URLs in parallel, retry blocked ones, and return metadata |\n\nEach prompt arrives as a templated user message your LLM executes with the right tools. The full prompt text enters the context only when you invoke it.\n\nFull recipe text + manual fallback prompts: [foura.ai/docs/mcp/recipes](https://foura.ai/docs/mcp/recipes). For the full error code list, see [foura.ai/docs/mcp/errors](https://foura.ai/docs/mcp/errors).\n\n## Authentication\n\nUse `FOURA_API_KEY` in stdio mode or an `Authorization: Bearer pk_live_...` header with the hosted endpoint. One key authenticates all four tools.\n\nKeys are managed in the [dashboard](https://foura.ai/dashboard/#api-keys), where you can create, reveal, rotate, or deactivate them. See [foura.ai/docs/getting-started/authentication](https://foura.ai/docs/getting-started/authentication) for the full key-management walkthrough.\n\n## Error envelope - typed contract for agent retries\n\nEvery error (`isError: true`) carries a `structuredContent` envelope with at minimum these three fields:\n\n```jsonc\n{\n \"service\": \"auto\" | \"single\" | \"proxy\" | \"browser\",\n \"code\": \"ssrf_blocked\" | \"auth_failed\" | \"rate_limited\" | ...,\n \"error\": \"Human-readable message\"\n}\n```\n\nWhere the upstream returned a status, you also get `status` (HTTP code) and on rate-limit / capacity errors the FourA API envelope adds `retryAfter`, `current.{concurrency, rpm}`, `limits.{maxConcurrency, maxRpm}`.\n\n| `code` | When | Retry safe? |\n|---|---|---|\n| `ssrf_blocked` | Target resolves to a private or reserved address | No - change the URL |\n| `upstream_non_json` | Upstream returned malformed body | Maybe - investigate |\n| `bad_request` (400) | Input shape rejected by FourA | No - fix arguments |\n| `auth_failed` (401) | Key missing, invalid, or deactivated | No - fix the key |\n| `forbidden` (403) | Authenticated but not allowed | No |\n| `not_found` (404) | Target / endpoint doesn't exist | No |\n| `rate_limited` (429) | RPM cap hit | Yes - wait `retryAfter` |\n| `at_capacity` (503) | Concurrency cap hit | Yes - wait `retryAfter` |\n| `service_disabled` (503) | Maintenance window | Yes - wait `retryAfter` |\n| `service_unavailable` (503) | Generic 503 | Yes - short backoff |\n| `upstream_error` (`>=500`) | Upstream 5xx | Yes - exponential backoff |\n| `upstream_client_error` (4xx) | Other 4xx | Usually no |\n| `no_eligible_proxy` | No proxy matches the requested `exitCountries` | No - change the country scope |\n\nLLM agents can read `code` directly for retry logic without parsing prose. Spec reference: [foura.ai/docs/api/errors](https://foura.ai/docs/api/errors).\n\n## Combining the tools - reuse the same exit\n\nThe lower-level tools compose. `foura_proxy` returns the base36 ID of the exit it used. Pass that ID into `foura_single.proxy` or `foura_browser.proxy` to reuse the same exit for the next request.\n\n```jsonc\n// 1. Find a working exit. Difficult protected targets may need maxTries:25-30.\nconst r = await foura_proxy({\n maxTries: 30,\n request: { method: \"GET\", url: \"https://probe.example.com\" }\n});\n// Returns { status: 200, proxy: \"4DZ3VE\", ... }\n\n// 2. Reuse it for follow-up HTTP\nawait foura_single({ method: \"GET\", url: \"https://target/api\", proxy: r.proxy });\n\n// 3. Or render JavaScript through the same exit.\nawait foura_browser({ url: \"https://target/spa\", proxy: r.proxy });\n```\n\nFor a protected JavaScript page, find a working route with `foura_proxy` before calling `foura_browser`. Starting in the browser can return the challenge page before the real content loads.\n\nTo choose a different proxy on the next `foura_proxy` call, pass the previous ID as `ignoreProxies: [\"4DZ3VE\"]`. The `proxy` field on `foura_single` and `foura_browser` also accepts raw URLs (`http://host:port`, `socks5://...`) if you have your own list.\n\n## Large responses - `offload_large` (default: inline)\n\nBy default (since v0.2.0), full response bodies are returned inline in `structuredContent` regardless of size. This works in every MCP client.\n\nIf your client supports MCP `resources/read` (and you want to save tokens on big pages), pass `offload_large: true` per tool call. Responses of 50 KB or more are returned as a `resource_link`, and your client fetches the body only when it needs it. The resource remains available for one hour.\n\n```jsonc\n{\n \"method\": \"GET\",\n \"url\": \"https://en.wikipedia.org/wiki/Web_scraping\",\n \"offload_large\": true // opt in for token savings\n}\n```\n\nSupport for MCP resource links varies by client. Leave `offload_large` at its default `false` if your client can't read `resource_link` blocks.\n\nOnly the API key that created an offloaded resource can read it back.\n\n## Limits and responsible use\n\n- **Private targets are refused.** Requests to private or reserved addresses are blocked at the MCP layer. Only public-internet hosts are forwarded.\n- **Rate limits** are enforced by the FourA API per service. Concurrency + RPM. Details at [foura.ai/docs/api/rate-limits](https://foura.ai/docs/api/rate-limits).\n\nUse FourA only for public content you are authorized to access and in accordance with the target site's terms and applicable law.\n\n## Run it yourself\n\nRun the stdio server directly from npm with `npx -y @fouradata/mcp`, or build the included [`Dockerfile`](https://github.com/fouradata/mcp/blob/main/Dockerfile) for the Streamable HTTP transport.\n\nConfigurable environment:\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `PORT` | `3076` | HTTP listen port |\n| `FOURA_API_BASE` | `https://api.foura.ai/api` | Upstream FourA REST base URL |\n| `FOURA_MCP_PAYLOADS_DIR` | `/data/payloads` | Where responses of 50 KB or more are cached on disk |\n\nSee [DEVELOPMENT.md](https://github.com/fouradata/mcp/blob/main/DEVELOPMENT.md) for the local build and test workflow.\n\n## License\n\nMIT. See [`LICENSE`](https://github.com/fouradata/mcp/blob/main/LICENSE).\n\n## Links\n\n- FourA (web scraping API): \n- MCP server page: \n- Source (GitHub): \n- npm package: \n- API documentation: \n- MCP server reference: \n- MCP error codes: \n- MCP recipes: \n- REST API errors: \n- MCP specification: \n- Get a key: \n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_113":114},"requiredSecrets",[],"tags",[97,98,99,100,101,102],"assets",[],"stats",{"_95":84,"_96":84},"ratingAvg","reviewCount","ai-agents","claude","cursor","llm-tools","typescript","web-scraping","topics",[97,98,99,100,21,119,120,101,102],"license","MIT","language","JavaScript","registryName","ai.foura/mcp","homepage","https://foura.ai/mcp","packages",[115],{"_116":117,"_118":22,"_74":75},"registryType","npm","identifier","mcp-server","model-context-protocol","ENV",{"_123":124,"_125":126,"_127":128},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]