Quick Start
Claude (Web — Pro, Max, Team, Enterprise)
- Get your personal MCP URL at app.fodda.ai → Connections (format:
https://mcp.fodda.ai/c/<your-token>)
- In Claude, go to Settings → Connectors → Add custom connector, paste the URL, and click Add
- Start chatting with your Fodda knowledge graphs
Note: Legacy URL query-string parameter authentication is deprecated and returns HTTP 401 with instructions. Get your fresh MCP URL or connect via OAuth at app.fodda.ai.
Claude Code (CLI)
claude mcp add --transport http fodda https://mcp.fodda.ai/mcp
claude mcp add --transport http fodda https://mcp.fodda.ai/mcp \
--header "Authorization: Bearer sk_live_..."
Client Setup Guides
For complete setup guides across all supported clients — Claude Web, Claude Code, Claude Enterprise, ChatGPT, OpenAI Responses API, Cursor, Gemini, and custom agents — visit https://www.fodda.ai/connect.
The Fodda MCP server exposes a rich suite of 30 tools to search, analyze, brainstorm, and visualize trends, expert-curated knowledge graphs, and corporate documents.
Discovery & Search
| Tool | Description | Deterministic |
|---|
list_graphs | Discover available knowledge graphs, metadata, and routing instructions. | ✅ |
search_graph | Hybrid keyword + semantic search across curated graphs for trend clusters and evidence. | ❌ |
search_statistics | Search for specific quantitative metrics, indicators, and numeric data points. | ❌ |
search_insights | Search expert quotes, qualitative signals, and professional interpretations. | ❌ |
get_label_values | Discover valid values for a node label or category. | ✅ |
Traversal & Graph Operations
| Tool | Description | Deterministic |
|---|
get_neighbors | Traverse from seed nodes to discover related concept nodes and links. | ✅ |
get_node | Retrieve detailed metadata, properties, and attributes for a single node by ID. | ✅ |
get_evidence | Retrieve source signals, articles, citations, and provenance for a trend or node. | ✅ |
discover_adjacent_trends | Find semantically similar trends to a given trend node. | ✅ |
Intelligence Domains
| Tool | Description | Deterministic |
|---|
get_domain_intelligence | Search all PSFK curated domain graphs (retail, beauty, sports, fashion, consumer electronics, F&B) in parallel. | ❌ |
get_expert_intelligence | Query specialist industry graphs built by leading strategists and experts. | ❌ |
get_report_intelligence | Search institutional report insights from DHL, PwC, Delta, and other partners. | ❌ |
Earnings & Corporate Insights
| Tool | Description | Deterministic |
|---|
get_earnings_intelligence | Query management commentary, business guidance, and Q&A from company earnings calls. | ❌ |
get_earnings_divergence | Detect deflections, gaps, and divergence between analyst concerns and executive responses in earnings calls. | ❌ |
Brand & Ideation
| Tool | Description | Deterministic |
|---|
brand_tracker | Compile a comprehensive Brand Intelligence Profile across all knowledge graphs. | ❌ |
brainstorm_topic | Graph-powered brainstorm map discovering unexpected connections and adjacent territories. | ❌ |
Deep Research & Execution Agents
| Tool | Description | Deterministic |
|---|
deep_research_topic | Launch an autonomous research session combining graphs with live web search. | ❌ |
check_research_status | Check progress or retrieve the final narrative report of a deep research job. | ✅ |
get_supplemental_context | Fetch macro context from up to 10 institutional data sources in a single query. | ❌ |
check_supplemental_status | Retrieve output from a supplemental context job. | ✅ |
Synthetic Analyst & Visualization
| Tool | Description | Deterministic |
|---|
list_analysts | List available Synthetic Analyst expert personas. | ✅ |
consult_analyst | Engage a Synthetic Analyst persona to synthesize answers with specialized voice. | ❌ |
generate_visual | Generate branded SVG data visualizations (Cultural Shifts, Competitive Compass, Innovation Pathway, etc.). | ❌ |
Note on Dynamic Partner Skills: When partner skills (such as Paralogy or Igloo) are enabled for a user's account, additional specialized tools (e.g. paralogy_analyze_trends, ideation tools) are dynamically registered on the MCP server and made available automatically.
Note on System Utilities: The server also registers several helper and account management utilities (e.g., get_my_account, toggle_graph_preference, update_user_profile, manage_scheduled_reports, send_feedback) to allow the AI assistant to query subscription status, manage scheduled briefings, or save personalization settings directly.
Discovery Endpoints
| Endpoint | Description |
|---|
GET /health | Health check ({ "status": "ok", "version": "..." }) |
POST /mcp | MCP endpoint — call the standard tools/list method on an initialized session to retrieve full tool schemas and capabilities |
Authentication
Preferred — HTTP header (used by the directory connection and all header-capable clients).
Pass your Fodda API key as a Bearer token:
Authorization: Bearer sk_live_...
The server also accepts the key via an X-API-Key: sk_live_... header.
In MCP request _meta:
{ "_meta": { "authorization": "Bearer sk_live_..." } }
Connection URLs. Web connector clients use personal tokenized connection URLs (https://mcp.fodda.ai/c/<token>) generated in your Connections dashboard. Raw keys in URLs are not accepted.
Configuration
| Variable | Description | Default |
|---|
PORT | HTTP server port | 8080 |
FODDA_API_URL | Upstream API base URL | https://api.fodda.ai |
FODDA_MCP_SECRET | HMAC signing secret for API requests | — |
NODE_ENV | Environment (development / production) | production |
Build & Run
npm install
npm run build
npm start
Self-Hosting
- Docker:
docker build -t fodda-mcp . && docker run -p 8080:8080 -e PORT=8080 fodda-mcp
- Cloud Run:
./deploy_cloud_run.sh
- Kubernetes: See
deployment/k8s/
- Terraform: See
deployment/terraform/
MCP Registry
This server is published to the Official MCP Registry as ai.fodda/mcp-server.
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=ai.fodda/mcp-server"
Privacy Policy
Full policy: https://www.fodda.ai/privacy
Summary of how the Fodda MCP server handles data (the hosted policy is authoritative):
- What we collect. Account information (name, email, organization) to manage your
account; usage data — API queries (query text, graph accessed, timestamps) logged for
billing, service improvement, and abuse prevention; and standard technical data (IP,
browser type, referral URLs). We do not store the full content of AI-generated
responses. Your API key authenticates requests and is never returned in tool output.
- How it's used. To provide and improve the Services, process billing, enforce rate
limits and prevent abuse, communicate support/service updates, and meet legal
obligations. Requests are proxied to the Fodda API (
https://api.fodda.ai) over TLS.
- Third-party sharing. We do not sell your personal information. Data is shared
only with service providers (e.g. payment processors, cloud hosting) under
confidentiality agreements, or when required by law.
- AI model training. Fodda does not use your queries or data to train AI models.
Knowledge graphs are expert-curated, not generated from user interactions.
- Retention. Account information is retained while your account is active; query logs
are retained for billing and analytics. You may request account/data deletion via the
contact below.
- Security. TLS-encrypted connections, API-key authentication, and secure cloud
infrastructure.
- Contact. Privacy inquiries: privacy@fodda.ai.
See the full hosted Privacy Policy (last updated
June 16, 2026) for the complete, authoritative terms.
Support
To report a security issue, email hello@fodda.ai with
"SECURITY" in the subject line.
License
Proprietary — fodda.ai
