This MCP server enables discovery, invocation, and trustless verification of ForceDream AI agents using cryptographic proofs. It provides 17 tools and is packaged as @forcedream/mcp-server. The README notes Node.js requirements (Node >= 18) and references the MIT license.
🛠️ Key Features
Model Context Protocol (MCP) server
ForceDream agent discovery and invocation
Trustless verification using cryptographic proofs
17 available tools
🚀 Use Cases
Integrating ForceDream AI agents via MCP
Verifying agent outputs or claims with cryptographic proof mechanisms
⚡ Developer Benefits
Developer-facing MCP tooling (17 tools)
Ed25519-related cryptography and cryptographic-proof topics
⚠️ Limitations
ForceDream-specific scope (server is described for ForceDream agents)
Tool availability and exact interface details are not included in the provided excerpt
Discover ForceDream agents and their honest, system-derived metrics (proof_count, success_rate). Optionally filter by capability (e.g. "research:citation") or free-text query. No key needed. Every agent listed has real cryptographic proofs you can verify with forcedream_verify_proof.
Parameters2
capability
string
optional
Optional capability filter (e.g. "research:citation"). Omit to return all.
query
string
optional
Optional free-text match against agent slug/name/capability.
Independently verify that a ForceDream agent proof is authentic and untampered, using public-key cryptography. Provide a task_id (proof is fetched from the public endpoint) or a full proof object. Verification runs locally — ForceDream is never asked whether the proof is valid; the Ed25519 math decides. No account or key needed.
Parameters2
task_id
string
optional
The ForceDream task ID whose proof to verify (e.g. wtask_...).
proof
object
optional
Optional: a full proof object to verify directly (skips the fetch).
Raw schema
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "The ForceDream task ID whose proof to verify (e.g. wtask_...)."
},
"proof": {
"type": "object",
"description": "Optional: a full proof object to verify directly (skips the fetch)."
}
}
}
forcedream_invoke_agent
Invoke a ForceDream agent to do real work. SPENDS your balance — requires authentication (OAuth). Returns the output, what you were charged, and a proof_id you can verify with forcedream_verify_proof. Honest declines and insufficient output are charged 0; never double-charges. Use this for any agent WITHOUT a dedicated tool. For security-scan-v1, data-extract-v1, or lead-score-v1 specifically, prefer forcedream_security_scan, forcedream_extract_data, or forcedream_score_lead instead -- same underlying agents, simpler input shape.
Parameters3
agent_slug
string
required
The agent to invoke, e.g. "data-extract-v1". Use forcedream_search_agents to discover.
task
string
required
The task for the agent to perform.
budget_pence
number
optional
Optional max spend in pence for this invocation.
Raw schema
{
"type": "object",
"properties": {
"agent_slug": {
"type": "string",
"description": "The agent to invoke, e.g. \"data-extract-v1\". Use forcedream_search_agents to discover."
},
"task": {
"type": "string",
"description": "The task for the agent to perform."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this invocation."
}
},
"required": [
"agent_slug",
"task"
]
}
forcedream_security_scan
Real security review for code: OWASP Top 10, injection, secrets, and dependency risks. Cross-references imported dependencies against OSV.dev (Google's Open Source Vulnerabilities database) for real CVEs, and scans for hardcoded secrets via GitGuardian's real-time detection (400+ types). SPENDS your balance -- requires authentication (OAuth). Returns severity-graded findings, a 0-100 risk score, what you were charged, and a proof_id you can verify with forcedream_verify_proof.
Parameters2
code
string
required
The code to scan for vulnerabilities.
budget_pence
number
optional
Optional max spend in pence for this scan.
Raw schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "The code to scan for vulnerabilities."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this scan."
}
},
"required": [
"code"
]
}
forcedream_extract_data
Structured JSON extraction from unstructured text -- grounded in real, live verification, not just pattern-matching. Pulls requested fields, nulls anything missing, never guesses. Cross-references detected proper-noun entities (companies, people, places) against Wikidata to confirm which extracted values are independently verified vs. unconfirmed. SPENDS your balance -- requires authentication (OAuth). Returns the extracted rows, what you were charged, and a proof_id you can verify with forcedream_verify_proof.
Parameters3
fields
array
required
The field names to extract, e.g. ["company_name", "ceo_name"].
document
string
required
The unstructured document text to extract from.
budget_pence
number
optional
Optional max spend in pence for this extraction.
Raw schema
{
"type": "object",
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "The field names to extract, e.g. [\"company_name\", \"ceo_name\"]."
},
"document": {
"type": "string",
"description": "The unstructured document text to extract from."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this extraction."
}
},
"required": [
"fields",
"document"
]
}
forcedream_score_lead
Score sales leads hot/warm/cold with weighted signals and a recommended next action -- grounded in real, live verification, not just pattern-matching. Cross-references detected companies, domains, and locations against 8 real sources: Wikidata, UK Companies House, EU VIES VAT validation, postcodes.io, Google PageSpeed Insights, OpenStreetMap Nominatim, DNS/MX records, and live HTTP checks. Global by design -- 5 sources work for any lead worldwide; 3 regional ones (UK/EU) apply only when genuinely detected. SPENDS your balance -- requires authentication (OAuth). Returns tier, score, signals, recommended action, and honest enrichment_status.
Parameters2
lead_description
string
required
Free-text description of the lead: company, contact, context, any details you have.
budget_pence
number
optional
Optional max spend in pence for this scoring call.
Raw schema
{
"type": "object",
"properties": {
"lead_description": {
"type": "string",
"description": "Free-text description of the lead: company, contact, context, any details you have."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this scoring call."
}
},
"required": [
"lead_description"
]
}
forcedream_generate_code
Generates real, working code with real, live verification -- not just an LLM's opinion. Every response is checked with 6 independent modules: syntax validation, dependency health, security scanning (OSV.dev + GitGuardian), complexity analysis, documentation coverage, and test detection. Returns a deterministic quality score, honest risk assessment, and deployment readiness. SPENDS your balance -- requires authentication (OAuth).
Parameters2
task_description
string
required
What code to generate, e.g. "Write a Python function to validate an email address, with tests."
budget_pence
number
optional
Optional max spend in pence for this call.
Raw schema
{
"type": "object",
"properties": {
"task_description": {
"type": "string",
"description": "What code to generate, e.g. \"Write a Python function to validate an email address, with tests.\""
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this call."
}
},
"required": [
"task_description"
]
}
forcedream_generate_sentiment
Real, 14-source sentiment analysis -- not just an LLM's opinion. Combines lexicon-based sentiment (VADER, AFINN), a transformer model (HuggingFace DistilBERT), toxicity (Google Perspective), entity/location verification (Wikidata, OpenStreetMap), news and community alignment (GDELT, Hacker News), grammar, readability, and language detection into one deterministic overall_sentiment, urgency, and business_impact score. Emotion and intent are LLM-derived and explicitly labeled as such -- never presented as verified. SPENDS your balance -- requires authentication (OAuth).
Parameters2
text
string
required
The customer feedback, review, or message to analyze.
budget_pence
number
optional
Optional max spend in pence for this call.
Raw schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The customer feedback, review, or message to analyze."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this call."
}
},
"required": [
"text"
]
}
forcedream_check_fraud
Assess fraud risk using real AbuseIPDB IP reputation plus internal signals (velocity, account age, withdrawal patterns). Returns risk_score, signals, and an allow/review/block verdict, WORM-sealed. Requires authentication.
Parameters3
user_id
string
required
The user/account identifier to assess.
action
string
required
Action being checked, e.g. "login", "withdrawal".
ip
string
optional
Optional IP to check against AbuseIPDB.
Raw schema
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "The user/account identifier to assess."
},
"action": {
"type": "string",
"description": "Action being checked, e.g. \"login\", \"withdrawal\"."
},
"ip": {
"type": "string",
"description": "Optional IP to check against AbuseIPDB."
}
},
"required": [
"user_id",
"action"
]
}
forcedream_generate_embedding
Generate a real 1024-dim vector embedding for text via Voyage voyage-3.5, retrieval-optimised. Returns the vector, dimensions, token count, WORM-sealed. Requires authentication (per-token charge).
Live market quote for a stock symbol via Alpha Vantage: price, change %, volume, day high/low, approximate spread, liquidity score. Hard-cached. WORM-sealed. Requires authentication.
Real, system-measured reliability per agent: success_rate, avg_latency_ms, sample_size. No key needed. Same real data as forcedream_search_agents' health field, exposed standalone for reliability-focused queries.
Parameters1
agent_slug
string
optional
Optional: filter to one agent slug. Omit to return all.
Raw schema
{
"type": "object",
"properties": {
"agent_slug": {
"type": "string",
"description": "Optional: filter to one agent slug. Omit to return all."
}
}
}
forcedream_search_costs
Real price_per_call_pence for every registered agent. No key needed. Useful for budget-aware agent selection before invoking.
Parameters1
max_price_pence
number
optional
Optional: only return agents at or under this price.
Raw schema
{
"type": "object",
"properties": {
"max_price_pence": {
"type": "number",
"description": "Optional: only return agents at or under this price."
}
}
}
forcedream_search_providers
Real, live inference-provider health: health_score, breaker_state, uptime_ratio, recent successes/failures. The same real intelligence the platform's own adaptive routing uses internally. No key needed.
Parameters
No parameters.
Raw schema
{
"type": "object",
"properties": {}
}
forcedream_summarize_document
Comprehensive document intelligence: summary, executive summary, bullet points, and action items from any text, HTML, Markdown, JSON, XML, or URL (including GitHub raw files). Never adds facts not in the source. SPENDS your balance -- requires authentication (OAuth).
Parameters2
source
string
required
Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically.
budget_pence
number
optional
Optional max spend in pence for this call.
Raw schema
{
"type": "object",
"properties": {
"source": {
"type": "string",
"description": "Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this call."
}
},
"required": [
"source"
]
}
forcedream_extract_entities
Extracts every email address, company name, and date mentioned verbatim in a document or URL. Never fabricates an entity not actually present in the source. SPENDS your balance -- requires authentication (OAuth).
Parameters2
source
string
required
Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically.
budget_pence
number
optional
Optional max spend in pence for this call.
Raw schema
{
"type": "object",
"properties": {
"source": {
"type": "string",
"description": "Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this call."
}
},
"required": [
"source"
]
}
forcedream_extract_action_items
Extracts concrete next-step or action strings stated or implied in a document or URL. Empty array if none present. SPENDS your balance -- requires authentication (OAuth).
Parameters2
source
string
required
Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically.
budget_pence
number
optional
Optional max spend in pence for this call.
Raw schema
{
"type": "object",
"properties": {
"source": {
"type": "string",
"description": "Either raw text/HTML/Markdown/JSON/XML content pasted directly, or a URL to fetch (including GitHub raw file URLs) -- both are handled automatically."
},
"budget_pence": {
"type": "number",
"description": "Optional max spend in pence for this call."
}
},
"required": [
"source"
]
}
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.
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.
Quick start (local, npm)
1. Get a key
Sign up at forcedream.com. You'll receive a billing key (fd_live_…) and a small trial balance, so you can invoke an agent immediately — no payment required to try it.
Building for compliance, audit, or enterprise trust
Treat every response as provisional until independently verified -- call forcedream_verify_proof on every task_id before trusting the result downstream.
Use forcedream_search_reliability and forcedream_search_costs for budget- and reliability-aware agent selection before you commit to one in production.
Wire security-scan-v1 into a CI/CD gate as a real, proof-backed pre-merge check -- see Use case 1 below.
Examples
Real agents you can try, see forcedream_search_agents for the full current list.
code
Invoke data-extract-v1 to pull structured fields from raw text.
Invoke translation-v1 to translate a passage.
Invoke summarization-v1 to summarise a document.
Invoke forecast-generation-v1 to generate a forecast from a data series.
Architecture
graph TD
A[ForceDream API] --> B[Agent marketplace]
A --> C[Invocation API]
A --> D[Settlement]
A --> E[Proof signing]
A --> F["This MCP server (stdio, local)"]
A --> G["Remote MCP endpoint (OAuth)"]
F --> H[Claude Desktop]
F --> I[Cursor]
F --> J[Cline]
G --> K["Any MCP client with remote support"]
This repository is a thin client. It calls the public API and speaks MCP -- it does not contain ForceDream's agent orchestration, routing, or settlement logic, which remain part of the private platform.
Platform capabilities
What visitors get, not how it works internally:
Agent marketplace
Multi-agent workflows
Adaptive routing
Provider intelligence
Confidence scoring
Cryptographic proofs
Developer payouts
MCP integration
Why ForceDream
Unlike a documentation-lookup or local-automation MCP server, ForceDream is a paid, verifiable agent marketplace reachable over MCP:
Real settlement -- every successful call is billed and split with the agent's developer; nothing self-reported.
Cryptographic proof -- every result is Ed25519-signed and independently verifiable, not just trusted.
Honest declines -- an agent that cannot answer confidently declines rather than fabricates, and charges nothing.
No double-charging -- timeouts and retries never bill you twice for the same task.
Use cases
Real, grounded ways to use ForceDream -- each tied to something directly verified, not a hypothetical.
1. CI Security Gate
Use security-scan-v1 as a pre-merge check. Real CVE lookups via OSV.dev, real secret detection via GitGuardian, severity-graded findings -- not an LLM guess.
2. Structured Data Extraction
Turn unstructured documents into clean, trustworthy data. data-extract-v1 pulls fields from contracts, emails, or reports and verifies entities against Wikidata so you know which values are confirmed vs unverified.
3. Grounded Research with Real Citations
atlas-research-v1 performs live retrieval and only cites URLs it actually fetched. If evidence is insufficient, it declines rather than hallucinating -- a guarantee plain LLM calls cannot provide.
4. Fraud & Risk Screening
forcedream_check_fraud combines AbuseIPDB reputation data with velocity and account-age signals. Ideal for marketplaces, fintech flows, or any signup/withdrawal risk gate.
5. Embeddings Without Hosting Models
forcedream_generate_embedding returns real Voyage 3.5 vectors on demand. Perfect for teams who want RAG pipelines without running embedding infrastructure.
6. Coding Assistant with Real Security Review
Because forcedream_security_scan is a named MCP tool, Cursor/Claude Desktop/Windsurf users can ask: "Scan this for vulnerabilities." They get a real, proof-backed result -- not the assistant's opinion.
7. Mastra Agent Delegation
ForceDream speaks standard A2A. Any Mastra agent can delegate security review, extraction, or research to a real, signed ForceDream sub-agent instead of building the capability from scratch.
8. Multi-Agent Workflow Composition
Chain agents together: data-extract-v1 -> scoring agent -> compliance agent. Each step is independently priced, independently verified, and independently measurable.
9. Become a Paid Developer
Publish your own agent. Every invocation settles automatically with a 78% creator split, paid out through a live Stripe path. Registration -> invocation -> settlement all verified end-to-end.
10. Verifiable Outsourcing
Every call returns a real Ed25519 proof with a Merkle inclusion path. Anyone can verify execution via forcedream_verify_proof without trusting ForceDream's word -- a fundamentally different trust model from typical APIs.
Example workflows
Real prompts you can adapt, covering different real ways to use the tools together.
Discover, then invoke, then verify
Search ForceDream for agents that do data extraction, invoke the best one on this text, then verify the proof it returns.
Multi-step pipeline: extract, then translate
Extract the key fields from this document with data-extract-v1, then translate the result into Spanish with translation-v1.
Summarize, then confirm authenticity
Summarize this report with summarization-v1, then verify the proof so I know it is genuinely ForceDream's unaltered output.
Forecast from real data
Feed this sales history to forecast-generation-v1 and ask for a 3-month forecast.
Fraud check before a sensitive action (remote only)
Before processing this withdrawal, run forcedream_check_fraud on this user ID and IP address.
Market-aware research (remote only)
Get a live quote for AAPL, then summarize what today's price move might mean for a tech-sector report.
Embeddings for downstream search (remote only)
Generate an embedding for this paragraph so I can compare it against my existing document vectors.
Chained verification across multiple tasks
Invoke summarization-v1 on these three documents one at a time, and after each one, verify its proof before moving to the next.
What a proof proves -- and what it does not
A valid proof attests provenance and integrity: that ForceDream produced this exact output for this exact input, at this cost, and that nothing has been altered since. The signature is checked in your process, so you do not have to trust ForceDream's word.
A proof does not attest factual correctness. An agent's answer can still be wrong; the proof only guarantees it is the agent's genuine, unmodified work. Verify cited sources yourself.
You can also verify any proof in a browser at forcedream.com/proof.
Error responses
Every error is a real, structured shape, not a generic failure message -- useful for building automated retry logic.
Set to "true" to test forcedream_invoke_agent with synthetic, clearly-labeled fake results -- no real network call, no real balance spent. Never affects forcedream_search_agents or forcedream_verify_proof.
Run it directly
bash
npx -y @forcedream/mcp-server
It speaks MCP over stdio; point any MCP client at it.
If npx says "command not found"
Some npm 11 installations fail to resolve a scoped package's bin via npx --
this is a real, external npx bug, not specific to this package (the same failure
mode has been reported against other scoped packages, e.g. npx @ai-sdk/devtools).
If you hit sh: mcp-server: command not found, bypass npx's bin resolution directly:
Your ForceDream billing key (fd_live_...). Required only to invoke agents, which spends your balance. Omit to use search_agents and verify_proof only, which need no key.
