fodda-mcp

Fodda MCP Server

Expert-curated knowledge graphs for AI agents — PSFK Retail, Beauty, Sports and partner datasets via the Model Context Protocol.

Quick Start

Claude (Web — Pro, Max, Team, Enterprise)

⚡ Quick Connect: Use this Add to Claude quick link (replace YOUR_API_KEY and YOUR_EMAIL in the URL before pressing enter).

Manual Setup:

• In Claude, go to Settings → Connectors → Add custom connector
• Enter URL: https://mcp.fodda.ai/mcp?api_key=YOUR_API_KEY&user_id=YOUR_EMAIL
• Under Advanced settings — leave OAuth Client ID and Secret blank (Fodda uses API key auth, not OAuth)
• Click Add — then start chatting with your Fodda knowledge graphs

Get your API key at app.fodda.ai → Account → MCP Integration.
Your API key starts with sk_live_...
Use the email address associated with your Fodda account for user_id.

Claude Code (CLI — SSE)

claude mcp add --transport sse fodda https://mcp.fodda.ai/sse \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Enterprise

For Claude Enterprise with admin-managed connectors, your workspace admin can register the Fodda MCP server using the same Streamable HTTP endpoint (https://mcp.fodda.ai/mcp) via the Admin Console. See Enterprise MCP Setup for full details.

OpenAI (Responses API — Recommended)

Use OpenAI's native MCP support — no function definitions needed:

from openai import OpenAI
client = OpenAI()

resp = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "fodda",
        "server_description": "Expert-curated knowledge graphs for retail, beauty, sports trends and earnings intelligence.",
        "server_url": "https://mcp.fodda.ai/mcp",
        "authorization": "Bearer YOUR_API_KEY",
        "require_approval": "never",
    }],
    input="What are the top emerging retail trends?",
)
print(resp.output_text)

import OpenAI from "openai";
const client = new OpenAI();

const resp = await client.responses.create({
  model: "gpt-5",
  tools: [{
    type: "mcp",
    server_label: "fodda",
    server_description: "Expert-curated knowledge graphs for retail, beauty, sports trends and earnings intelligence.",
    server_url: "https://mcp.fodda.ai/mcp",
    authorization: "Bearer YOUR_API_KEY",
    require_approval: "never",
  }],
  input: "What are the top emerging retail trends?",
});
console.log(resp.output_text);

Tip: To reduce latency with 30+ tools, use allowed_tools to filter: "allowed_tools": ["search_graph", "search_statistics", "brand_tracker"]

Legacy: If you're using chat.completions.create() with function calling, define a custom function that calls the Fodda REST API. See fodda.ai/connect for details.

Generic Streamable HTTP Client

Connect to the /mcp endpoint using HTTP POST (Streamable HTTP) with Authorization: Bearer YOUR_API_KEY:

https://mcp.fodda.ai/mcp

Gemini CLI

{
  "tools": [{
    "type": "mcp",
    "name": "fodda",
    "url": "https://mcp.fodda.ai/sse",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  }]
}

Generic SSE Client

Connect to https://mcp.fodda.ai/sse with an Authorization: Bearer YOUR_API_KEY header.

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.	✅

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_..." } }

Fallback — URL query parameter. Some clients (e.g. the Claude.ai web custom connector UI) cannot set custom request headers. For those, the key may be passed as ?api_key=.... This is provided only for compatibility; prefer header-based auth wherever the client supports it, since URLs are more likely to be logged by intermediaries. The server never returns your API key in tool output.

Configuration

Variable	Description	Default
PORT	HTTP server port (omit for stdio mode)	—
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

# Stdio mode
npm start

# SSE mode
PORT=8080 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: [e-mail].

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

Support

• Email: [e-mail]
• Account & API keys: app.fodda.ai → Account → MCP Integration
• Documentation: fodda.ai

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

License

Proprietary — fodda.ai