ai.foura/mcp
NPM · @FOURADATA/MCP · 2 COMPONENTS · SCANNED AUG 3
Reliable web access for AI agents: smart HTTP, rotating proxies, and full-browser rendering.
Available components
+30 this week
79 79 Trust /100
Trust breakdown (6 categories)
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to fouradata/mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 20 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability72
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2000 tokens (~500/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @fouradata/mcp
# add to Claude Code
claude mcp add ai-foura-mcp -- npx -y @fouradata/mcp
# add to Codex CLI
codex mcp add ai-foura-mcp -- npx -y @fouradata/mcp
// opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ai-foura-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@fouradata/mcp"
],
"enabled": true
}
}
} # add to OpenClaw
openclaw mcp add ai-foura-mcp --command npx --arg -y --arg @fouradata/mcp
# ~/.hermes/config.yaml
mcp_servers:
ai-foura-mcp:
command: "npx"
args: ["-y", "@fouradata/mcp"] // mcp.json
{
"mcpServers": {
"ai-foura-mcp": {
"command": "npx",
"args": [
"-y",
"@fouradata/mcp"
]
}
}
} Changelog
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +59
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: fouradata/mcp security
- Security disclosure: unverified → fail ▼ functional
- Stability: unverified → 0.27 ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Schema quality: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- 2 Aug 26 −30
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Schema quality: 100 → unverified ▼ functional
- 1 Aug 26 −11
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 +12
- Malware scan: pass → unverified ▼ security
- Provenance: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- The attested source repository moved: fouradata/mcp security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
- 29 Jul 26 +25
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- 28 Jul 26 −25
- Schema quality: 100 → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 27 Jul 26 49
First indexed and scored.
Diagnostics
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/@fouradata/[email protected]
Provenance verified
Ecosystem: npm · Outcome: verified
Reason: verified
- Source repo:
- fouradata/mcp
- Certificate issuer:
- https://token.actions.githubusercontent.com
- Certificate SAN:
- https://github.com/fouradata/mcp/.github/workflows/publish.yml@refs/tags/v0.5.0
- Rekor log index:
- 2163060196
- Predicate type:
- https://slsa.dev/provenance/v1
- Subject digest:
- sha512:65422bfdea0a6b20ce3f5c40464fb398e030e5be353a299dedd33b77f0a41821be249e105135a494b20a9c48b95d81e037b27a428e51a24122dae4cfc
- Discovery method:
- attestation_endpoint
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
MCP tools
— 4 exposed
· ~2,000 tokens
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
Tool
Tokens
foura_auto FourA - auto (smart fetch, picks the method for you) ~492
Give it a public URL and get the content back. This is the default when you don't want to choose between HTTP, proxy rotation, and a full browser. On protected targets, or whenever HTTP 200 may still be a challenge or incomplete page, pass validate.data.accept with text unique to the real content. Auto makes bounded attempts and returns either validated content or a failure; it cannot guarantee a match. The response includes completion details and, by default, reusable session values for follow-up calls. Use a lower-level tool when you need direct control over HTTP, proxy selection, or browser navigation.
| Name | Type | Req | Description |
|---|---|---|---|
| data | — | — | Request body for non-GET methods. Strings sent as-is; objects auto-serialized to JSON. |
| followRedirects | integer | — | Follow up to N redirects for HTTP and proxy requests. Default 5; 0 means don't follow. Browser navigation handles redirects itself. |
| forceProxy | boolean | — | Require proxy routing for every target request. Default true. Send false to allow direct HTTP when suitable. |
| headers | array | — | Custom HTTP headers as [name, value] tuples. Example: [["Accept", "application/json"], ["Authorization", "Bearer ..."]] |
| ignoreProxies | array | — | Exits to avoid - base36 proxy IDs (like "4DZ3VE") or proxy URLs. Use this to rotate away from an exit that was just blocked. |
| method | string | — | HTTP method for the target request (default GET). |
| offload_large | boolean | — | If true, response bodies of 50 KB or more are returned as a resource_link instead of inlined. Default false. Read the returned offloaded_resource_uri with resources/read. |
| returnSession | boolean | — | Return reusable {proxy, cookies, userAgent} values for follow-up calls. Default true. Send false for a leaner response when you only need the content. |
| timeout_ms | integer | — | Total time budget in ms for the whole operation. Every attempt must fit inside it. Default 120000, max 180000. |
| url | string | yes | Public target URL. Private or reserved targets return `ssrf_blocked`. Use {ts} in the URL to insert the current Unix timestamp. Example: https://example.com/page. |
| validate | object | — | Post-fetch response validation. When the response fails these checks foura_auto returns an error envelope. |
| Name | Type | Req | Description |
|---|---|---|---|
| attempts | number | — | Total attempts when the request failed (also present inside `meta`). |
| code | string | — | Stable error code for retry classification. auth_failed means the FourA API key was rejected; verify that key, not target-site credentials. Other codes: ssrf_blocked, upstream_non_json, output_valida… |
| current | object | — | Caller's current usage at error time |
| data | — | — | Decoded response body of the delivered page. String by default; object when the body parsed as JSON. Omitted when offloaded. |
| error | string | — | Human-readable error message when the request could not deliver content within the budget. |
| headers | — | — | Response headers from the successful request, as an array of objects. Each entry has `result.{version, code, reason}` plus header-name keys. The last entry is the final response. |
| limits | object | — | Per-service limits at error time |
| meta | object | — | Completion details: rung, solved, attempts, and credits. Always present. |
| offloaded_resource_uri | string | — | foura-mcp://payload/<uuid>. Pass this URI to resources/read to retrieve the offloaded body. |
| retryAfter | number | — | Seconds to wait before retrying a 429 or 503 response |
| service | string | — | — |
| session | object | — | Reusable {proxy, cookies, userAgent} values for follow-up calls. For plain HTTP, call foura_single with session.proxy as proxy, session.userAgent as a User-Agent header, and session.cookies serialize… |
| size_bytes | integer | — | Total offloaded body size in bytes |
| status | integer | — | HTTP status code from the request that delivered the content. `0` means no HTTP response was received; check `error`. |
No examples provided.
foura_browser FourA - full browser navigation ~456
Load a public URL in a full browser session. JavaScript runs, the DOM renders, and cookies come back with the response. Use it for single-page apps, lazy-loaded content, or supported browser challenges. For a protected page, call foura_proxy first and pass its returned proxy ID here to reuse that exit. Set unblocker:false when you want the page exactly as it loads.
| Name | Type | Req | Description |
|---|---|---|---|
| checkStatus | integer | — | Expected HTTP status code. A different status returns an error envelope carrying the actual value. Example: 200 for a product page. |
| checkText | string | — | Validate the rendered HTML once navigation completes. This is a substring check, not a waiter, and it doesn't poll. A missing substring returns an error envelope. Example: "add to cart" for a product… |
| cookies | array | — | Cookies to set before navigation: [{ name, value, domain? }] |
| headers | object | — | Custom HTTP headers as a key-value object rather than [name, value] tuples. Example: {"Referer": "https://google.com/"} |
| offload_large | boolean | — | If true, response bodies of 50 KB or more are returned as a resource_link instead of inlined. Default false. Read the returned offloaded_resource_uri with resources/read. |
| proxy | string | — | Optional proxy. Three forms: (1) URL `http://user:pass@host:port` or `socks5://host:port`; (2) base36 ID from foura_proxy (e.g. `4DZ3VE`) to reuse the same exit; (3) omit to use the default route. |
| timeout_ms | integer | — | Page load timeout in ms (default 30000, max 120000) |
| unblocker | boolean | — | Handle supported anti-bot or captcha challenges during navigation. Default true. Set false to return the page exactly as it loads, including any challenge page. |
| url | string | yes | Public URL to load in a full browser session. Private or reserved targets return `ssrf_blocked`. Example: https://shop.example.com/product/123. |
| userAgent | string | — | Override the browser's User-Agent string |
| Name | Type | Req | Description |
|---|---|---|---|
| body | — | — | Fully-rendered page content. String HTML when content-type is HTML; object when the page returned JSON and it was auto-parsed. Field is named `body`, not `data`. Omitted when offloaded. |
| code | string | — | Stable error code for retry classification. auth_failed means the FourA API key was rejected; verify that key, not target-site credentials. Other codes: ssrf_blocked, upstream_non_json, output_valida… |
| cookies | array | — | Full cookie objects collected after navigation, including name, value, domain, path, expiry, and same-site settings. |
| current | object | — | — |
| error | string | — | Human-readable error message |
| headers | object | — | Response headers as a flat key-value object. Values are typically strings but may be arrays for repeated headers. |
| limits | object | — | — |
| offloaded_resource_uri | string | — | foura-mcp://payload/<uuid>. Pass this URI to resources/read to retrieve the offloaded body. |
| retryAfter | number | — | — |
| service | string | — | — |
| size_bytes | integer | — | Total offloaded body size in bytes |
| status | integer | — | HTTP status code from the target page. `0` indicates the navigation failed before any HTTP response (DNS / connection refused / timeout) - check the `error` field for the underlying reason. |
| userAgent | string | — | The User-Agent the browser session presented |
No examples provided.
foura_proxy FourA - HTTP request via rotating proxies ~341
Route an HTTP request through rotating proxies with automatic retry. Use it when foura_single is blocked or the target requires a specific exit country. The response includes the proxy ID that succeeded; reuse it with foura_single or foura_browser, or exclude it with ignoreProxies. Use foura_browser when the page needs JavaScript. Set exitCountries for a strict country allowlist.
| Name | Type | Req | Description |
|---|---|---|---|
| exitCountries | array | — | Optional target-visible proxy countries as two-letter provider codes, for example ["CZ", "GB"]. Use codes supplied by the user or target requirements. When geography matters, do not guess codes or su… |
| ignoreProxies | array | — | Encoded proxy IDs (base36 strings like "4DZ3VE") or proxy URLs to exclude from rotation. |
| maxTries | integer | — | Maximum rotation attempts before giving up (default 5, max 90). Difficult protected targets may need 25-30. Use exitCountries for country scope. |
| offload_large | boolean | — | If true, response bodies of 50 KB or more are returned as a resource_link instead of inlined. Default false. Read the returned offloaded_resource_uri with resources/read. |
| request | object | yes | The inner HTTP request to send through each proxy attempt. Validation rules here determine when a proxy is treated as failed and retried. |
| timeout_ms | integer | — | Overall timeout across all rotation attempts in ms (default 45000, max 120000). Must be positive. |
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | — | Stable error code for retry classification. auth_failed means the FourA API key was rejected; verify that key, not target-site credentials. no_eligible_proxy means the strict exitCountries scope had… |
| current | object | — | — |
| data | — | — | Decoded response body. Omitted when offloaded. |
| details | object | — | Structured no_eligible_proxy context containing the normalized requested country scope. Preserve this scope and retry later. Do not propose or perform an unscoped fallback; change it only after the u… |
| error | string | — | Human-readable error message |
| exitCountry | string | — | Latest available two-letter target-visible exit-country code used for selection. Present on successful requests that use exitCountries. |
| headers | — | — | Response headers per redirect hop, as an array of objects. Each entry has `result.{version, code, reason}` plus arbitrary header-name keys whose values are strings (or arrays of strings for multi-val… |
| limits | object | — | — |
| offloaded_resource_uri | string | — | foura-mcp://payload/<uuid>. Pass this URI to resources/read to retrieve the offloaded body. |
| proxy | string | — | Base36 ID of the exit that succeeded (e.g. `4DZ3VE`). Pass it to foura_single.proxy or foura_browser.proxy to reuse that exit, or to foura_proxy.ignoreProxies to skip it on future rotations. |
| request | — | — | Echoed PrRequest from upstream PrResponseError |
| retryAfter | number | — | — |
| service | string | — | — |
| size_bytes | integer | — | Total offloaded body size in bytes |
| status | integer | — | HTTP status code from the target (from the succeeding proxy attempt). `0` indicates every attempt failed before any HTTP response (DNS / connection refused / timeout) - check the `error` field for th… |
| total | number | — | Outer total time in seconds (proxy selection + retries + the successful inner attempt). Float. |
| total_time | — | — | Per-attempt wall-clock duration of the succeeding inner request |
No examples provided.
foura_single FourA - single HTTP request ~711
Send one HTTP request and return the response. Use it for static pages, JSON APIs, and server-rendered HTML. Set unblocker:true for targets that reject basic HTTP requests. Switch to foura_proxy if the response is blocked, and use foura_browser when the page needs JavaScript.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_timeout_ms | integer | — | Timeout in ms to receive the first response byte after the request is sent (0-120000). Omit for the default. |
| connect_timeout_ms | integer | — | Timeout in ms for establishing the TCP/TLS connection (0-120000). Omit to use the default. |
| data | — | — | Request body. Strings sent as-is; objects auto-serialized to JSON. Example: {"query": "hello"} for POST APIs. |
| dns_cache_timeout_sec | integer | — | How long (seconds) to cache the target's resolved DNS (0-240). Omit for the default. |
| followRedirects | integer | — | Max number of redirects to follow (0-20). Omit to disable redirect following. |
| headers | array | — | Custom HTTP headers as [name, value] tuples. Example: [["Accept", "application/json"], ["Referer", "https://google.com/"]] |
| method | string | yes | HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, or any WebDAV verb like PROPFIND/MKCOL) |
| offload_large | boolean | — | If true, response bodies of 50 KB or more are returned as a resource_link instead of inlined. Default false. Read the returned offloaded_resource_uri with resources/read. |
| proxy | string | — | Optional proxy. Two forms: (1) URL `http://host:port` or `socks5://host:port`; (2) base36 ID from foura_proxy (e.g. `4DZ3VE`) to reuse the same exit. For rotation, use foura_proxy. |
| returnBuffer | boolean | — | Return raw bytes as a serialized Buffer JSON shape (`{type:"Buffer", data:[byte, ...]}`, bytes 0-255) instead of decoded string. Use for binary responses (images, protobuf). Reconstruct: `Buffer.from… |
| server_response_timeout_ms | integer | — | Timeout in ms for the server to send the complete response (0-120000). Omit for the default. |
| timeout_ms | integer | — | Overall request timeout in ms (max 120000, default 15000) |
| tryJsonData | boolean | — | If true, attempt JSON.parse on the response body. On success, `data` is the parsed value (typically object or array). On parse failure, `data` silently stays as the original string - no error, no war… |
| unblocker | boolean | — | Add common browser headers such as User-Agent, Sec-Ch-Ua, and Accept-Encoding. Default false. Enable it for targets that reject basic HTTP requests. |
| url | string | yes | Public target URL. Private or reserved targets return `ssrf_blocked`. Use {ts} in the URL to insert the current Unix timestamp. Example: https://api.example.com/v1/users. |
| validate | object | — | Post-fetch response validation. When the response fails these checks the tool returns an error envelope. |
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | — | Stable error code for retry classification. auth_failed means the FourA API key was rejected; verify that key, not target-site credentials. Other codes: ssrf_blocked, upstream_non_json, output_valida… |
| current | object | — | Caller's current usage at error time |
| data | — | — | Decoded response body. String by default; object when tryJsonData=true and the body parsed as JSON; serialized Buffer JSON shape (`{type:"Buffer", data:[byte, ...]}`, bytes 0-255) when returnBuffer=t… |
| error | string | — | Human-readable error message |
| headers | — | — | Response headers per redirect hop, as an array of objects. Each entry has `result.{version, code, reason}` plus arbitrary header-name keys whose values are strings (or arrays of strings for multi-val… |
| limits | object | — | Per-service limits at error time |
| offloaded_resource_uri | string | — | foura-mcp://payload/<uuid>. Pass this URI to resources/read to retrieve the offloaded body. |
| retryAfter | number | — | Seconds to wait before retrying (429/503) |
| service | string | — | — |
| size_bytes | integer | — | Total offloaded body size in bytes |
| status | integer | — | HTTP status code from the target. `0` indicates the request failed before any HTTP response (DNS failure, connection refused, timeout) - check the `error` field for the underlying reason. |
| total_time | — | — | Wall-clock request duration in seconds. Number when present; string in some variants; null when the request never started. |
No examples provided.