Fodda Knowledge Graphs

السجل الرسمي البحث والويب

Expert-curated knowledge, brand, research & earnings intelligence — 46 tools, 220+ graphs.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http fodda-knowledge-graphs 'https://mcp.fodda.ai/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "fodda-knowledge-graphs": {
            "type": "http",
            "url": "https://mcp.fodda.ai/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Fodda MCP Server
  2. Quick Start
  3. Available Tools
  4. Authentication
  5. Configuration
  6. Build & Run
  7. Self-Hosting
  8. MCP Registry
  9. Privacy Policy
  10. Support
  11. License

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

ToolDescriptionDeterministic
list_graphsDiscover available knowledge graphs, metadata, and routing instructions.✅
search_graphHybrid keyword + semantic search across curated graphs for trend clusters and evidence.❌
search_statisticsSearch for specific quantitative metrics, indicators, and numeric data points.❌
search_insightsSearch expert quotes, qualitative signals, and professional interpretations.❌
get_label_valuesDiscover valid values for a node label or category.✅
Traversal & Graph Operations
ToolDescriptionDeterministic
get_neighborsTraverse from seed nodes to discover related concept nodes and links.✅
get_nodeRetrieve detailed metadata, properties, and attributes for a single node by ID.✅
get_evidenceRetrieve source signals, articles, citations, and provenance for a trend or node.✅
discover_adjacent_trendsFind semantically similar trends to a given trend node.✅
Intelligence Domains
ToolDescriptionDeterministic
get_domain_intelligenceSearch all PSFK curated domain graphs (retail, beauty, sports, fashion, consumer electronics, F&B) in parallel.❌
get_expert_intelligenceQuery specialist industry graphs built by leading strategists and experts.❌
get_report_intelligenceSearch institutional report insights from DHL, PwC, Delta, and other partners.❌
Earnings & Corporate Insights
ToolDescriptionDeterministic
get_earnings_intelligenceQuery management commentary, business guidance, and Q&A from company earnings calls.❌
get_earnings_divergenceDetect deflections, gaps, and divergence between analyst concerns and executive responses in earnings calls.❌
Brand & Ideation
ToolDescriptionDeterministic
brand_trackerCompile a comprehensive Brand Intelligence Profile across all knowledge graphs.❌
brainstorm_topicGraph-powered brainstorm map discovering unexpected connections and adjacent territories.❌
Deep Research & Execution Agents
ToolDescriptionDeterministic
deep_research_topicLaunch an autonomous research session combining graphs with live web search.❌
check_research_statusCheck progress or retrieve the final narrative report of a deep research job.✅
get_supplemental_contextFetch macro context from up to 10 institutional data sources in a single query.❌
check_supplemental_statusRetrieve output from a supplemental context job.✅
generate_comms_plan2026 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
ToolDescriptionDeterministic
list_analystsList available Synthetic Analyst expert personas.✅
consult_analystEngage a Synthetic Analyst persona to synthesize answers with specialized voice.❌
generate_visualGenerate 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
EndpointDescription
GET /healthHealth check ({ "status": "ok", "version": "..." })
POST /mcpMCP 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

VariableDescriptionDefault
PORTHTTP server port8080
FODDA_API_URLUpstream API base URLhttps://api.fodda.ai
FODDA_MCP_SECRETHMAC signing secret for API requests—
NODE_ENVEnvironment (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: 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

الأسئلة الشائعة

ما هو Fodda Knowledge Graphs؟

Expert-curated knowledge, brand, research & earnings intelligence — 46 tools, 220+ graphs.

كيف أثبّت Fodda Knowledge Graphs؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http fodda-knowledge-graphs 'https://mcp.fodda.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Fodda Knowledge Graphs إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Fodda Knowledge Graphs مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Fodda Knowledge Graphs؟

ينشره piers-fawkes. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.