Fodda Knowledge Graphs

io.github.piers-fawkesPublished by GitHub account piers-fawkesv1.30.0Updated Oct 24, 2026

Expert-curated knowledge graphs for AI agents — retail, beauty, sports, plus institutional data

The publisher's own server: Fodda Brand Intelligence

Overview

AI-generated overview

Gives an assistant read-only access to Fodda's expert-curated knowledge graphs for retail, beauty, sports, earnings, and institutional research.

What you can do
Exposes a research suite of roughly 30 tools for searching and traversing curated knowledge graphs: graph discovery, hybrid keyword and semantic search, statistics and insight search, node and neighbor traversal, and evidence retrieval with provenance. Additional tools cover domain and expert intelligence, institutional report data, company earnings commentary and divergence analysis, brand profiling, brainstorming, deep research sessions, synthetic analyst personas, and SVG data visualizations. A scoped read-only connector variant suppresses administrative and onboarding tools.
When to use it
Useful when an assistant needs curated market, trend, brand, or earnings intelligence rather than open web results, for example trend research, competitive and brand analysis, or synthesizing institutional reports. Worth adding if you already work with PSFK-style retail, beauty, sports, or consumer datasets and want them queryable in chat.
Requirements
Runs as a local npm package (fodda-mcp) over stdio, or connects to the hosted endpoint. Requires a Fodda API key supplied as FODDA_API_KEY or an Authorization Bearer header; OAuth via the hosted connector is also supported. Optional settings include FODDA_API_URL, PORT, FODDA_MCP_SECRET, and NODE_ENV. Node.js and network access to the Fodda API are needed.
Before you install
The API key is a billable credential; keep it out of URLs and logs. Queries, graph accessed, and timestamps are logged for billing and abuse prevention, and requests are proxied to the Fodda API over TLS. Some tools launch autonomous research or supplemental-context jobs, and account utilities can change preferences, profile, and scheduled reports. Trial credits are limited, so usage may incur cost.

Installation

In SourceWeft

  1. Open Fodda Knowledge Graphs in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Fodda Logo]

Fodda MCP Server

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

[MCP Registry] [npm] [Version] [License]


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)

bash
# 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

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:

json
{ "_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

bash
npm installnpm run buildnpm 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.

bash
# Verify listingcurl "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

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


License

Proprietary — fodda.ai

Source: README.md at commit f0381ed

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.30.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Fodda integrations