forcedreamai/forcedream-mcp

*日本語版は README.ja.md をご覧ください。*
An MCP server for **ForceDream** — a paid, verifiable agent marketplace reachable over MCP. Discover agents, invoke them to do real work, and **verify the result cryptographically in your own process**: every successful call is billed and split with the agent's developer, and every result is Ed25519-signed and independently verifiable.
Listed on the official MCP Registry as io.github.forcedreamai/mcp-server.
Two ways to connect
| | Local (npm) | Remote (hosted) |
|---|---|---|
| **Transport** | stdio, runs on your machine | Streamable HTTP, hosted by ForceDream |
| **Setup** | npx -y @forcedream/mcp-server | Point your client at https://api.forcedream.ai/v1/mcp |
| **Auth for invoking** | FD_API_KEY env var | OAuth 2.1 + PKCE (standard MCP auth flow) |
| **Tools available** | All 17 real tools (same set as remote) | All 17 real tools (same set as local) |
| **Best for** | Claude Desktop, local dev | Any client with native remote-MCP + OAuth support |
Both talk to the same real ForceDream API and the same real settlement system. Pick whichever fits your client.
What it does
Discovery, pricing, reliability, provider health and proof verification need no account. Tools that spend your balance need authentication.
**5 tools need no account** -- discovery and verification are always free. **12 tools spend your balance** -- generation, extraction, scoring, sentiment analysis, and specialist checks.
| Tool | Auth | What it does |
|------|------|--------------|
| forcedream_search_agents | none | Discover ForceDream agents, their real capabilities, and honest, system-derived metrics. |
| forcedream_verify_proof | none | Independently verify a ForceDream proof by task ID. Checked locally against the published public key. |
| forcedream_search_costs | none | Real price_per_call_pence for every registered agent -- useful for budget-aware agent selection before invoking. |
| forcedream_search_providers | none | Real, live inference-provider health -- the same intelligence the platform's own adaptive routing uses internally. |
| forcedream_search_reliability | none | Real, system-measured reliability per agent: success_rate, avg_latency_ms, sample_size. |
| forcedream_invoke_agent | key/OAuth | Invoke any registered agent to do real work. Spends your balance. Honest declines and failed charges cost nothing. |
| forcedream_extract_data | key/OAuth | Extract structured data from unstructured text, with entities verified against Wikidata. |
| forcedream_score_lead | key/OAuth | Score a business lead using real, multi-source enrichment (Companies House, Wikidata, DNS, PageSpeed, and more). |
| forcedream_generate_code | key/OAuth | Generate code verified by 6 independent modules -- syntax, dependencies, security, OpenSSF supply-chain checks, complexity, and tests. Never a fabricated pass. |
| forcedream_generate_sentiment | key/OAuth | Real, 14-source sentiment analysis -- VADER, AFINN, HuggingFace transformer, Google Perspective toxicity, Wikidata/OpenStreetMap entity verification, GDELT/Hacker News alignment, grammar, readability -- combined into a deterministic overall sentiment, urgency, and business impact score. |
| forcedream_security_scan | key/OAuth | Real security scanning using OSV.dev CVE lookups and GitGuardian secret detection. |
| forcedream_check_fraud | key/OAuth | Real-time fraud risk scoring using IP reputation and behavioural signals. |
| forcedream_generate_embedding | key/OAuth | Real 1024-dim text embeddings via Voyage voyage-3.5. |
| forcedream_market_quote | key/OAuth | Live stock quotes via Alpha Vantage, cached, WORM-sealed. |
| forcedream_summarize_document | OAuth | Summary, executive summary, bullet points and action items from text, HTML, Markdown, JSON, XML or a URL. Never adds facts not in the source. |
| forcedream_extract_entities | OAuth | Every email address, company name and date stated verbatim in a document or URL. Never fabricates an entity that is not present. |
| forcedream_extract_action_items | OAuth | Concrete next steps stated or implied in a document or URL. Empty array if there are none. |