Fodda

---

Quick Start

Claude (Web & Desktop — Scoped Research Connector)

Fodda provides a dedicated scoped endpoint optimized for research and expert advisory in Claude: https://mcp.fodda.ai/claude. It exposes a curated 30-tool suite (knowledge graphs, company earnings transcripts, macroeconomic data, synthetic analyst consultation, and commissioned deliverables) with all internal administrative and expert-onboarding mutators suppressed.

1. In Claude, go to Settings → Connectors → Add custom connector
2. Enter Name: Fodda and URL: https://mcp.fodda.ai/claude
3. Authorize via Clerk OAuth (supports Google/LinkedIn SSO and email code) — your account is auto-provisioned with 100 free trial credits
4. Start querying market intelligence, earnings divergence, and expert graphs

Alternatively, you can connect using your personal tokenized URL from app.fodda.ai → Connections (format: https://mcp.fodda.ai/c/<your-token>).

Note: Legacy URL query-string parameter authentication is deprecated and returns HTTP 401 with instructions. Connect via OAuth at https://mcp.fodda.ai/claude or use your tokenized connection URL.

Claude Code (CLI)

# Connect to the curated Claude research connector via OAuth:
claude mcp add --transport http fodda https://mcp.fodda.ai/claude

# Or with an API key:
claude mcp add --transport http fodda https://mcp.fodda.ai/claude \
  --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.

---

Available Tools

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.	✅
generate_comms_plan	2026 Strategy-to-Activation Comms & Retail Media Plan with T1-T5 tasks, 3-layer shopper audience cards, digital shelf intelligence, and activation manifest.	❌

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.

# Verify listing
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: [email protected].

See the full hosted Privacy Policy (last updated June 16, 2026) for the complete, authoritative terms.

---

Support

• Email: [email protected]
• Account & API keys: app.fodda.ai → Connections
• Documentation: fodda.ai

To report a security issue, email [email protected] with "SECURITY" in the subject line.

---

License

Proprietary — fodda.ai