The Fodda MCP Server provides AI agents with access to expert-curated knowledge graphs (PSFK Retail, Beauty, Sports, and partner datasets) to explore trends, discover relationships, and retrieve sourced intelligence.
Search knowledge graphs (
search_graph): Hybrid vector + keyword search across graphs (retail, beauty, sports, psfk, sic, waldo) with a 3-tier fallback to always return results.Traverse relationships (
get_neighbors): Start from seed nodes and explore connected concepts up to 2 levels deep, optionally filtering by relationship type.Retrieve source evidence (
get_evidence): Get sourced signals, articles, URLs, and provenance data for any node — useful for fact-checking and citation.Fetch node metadata (
get_node): Retrieve full metadata, labels, display name, and properties for any node by its ID.Discover label/category values (
get_label_values): List all valid values for a given node label or category (e.g., RetailerType, Technology) — useful for filtering and exploration.Get macro industry overviews (
psfk_overview): Retrieve structured briefings across PSFK industries and sectors, with up to 3 meta-patterns filterable by industry, sector, region, and timeframe.System integration: Supports SSE, HTTP, and stdio protocols (Claude, OpenAI, Gemini), API key auth, rate limiting, and self-hosting via Docker, Kubernetes, or Cloud Run.
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 Code (Streamable HTTP fallback to SSE)
claude mcp add --transport sse fodda https://mcp.fodda.ai/sse \
--header "Authorization: Bearer YOUR_API_KEY"OpenAI Frontier or Streamable HTTP Client
Connect to the /mcp endpoint using HTTP GET to establish a stream and POST to execute:
https://mcp.fodda.ai/mcpGemini 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
Tool | Description | Deterministic |
| Hybrid keyword + semantic search on a knowledge graph | ❌ |
| Traverse from seed nodes to discover related concepts | ✅ |
| Source signals, articles, and provenance for a node | ✅ |
| Retrieve metadata for a single node by ID | ✅ |
| Discover valid values for a node label/category | ✅ |
| Structured macro overview across industries and sectors | ❌ |
All tools require userId and — except psfk_overview — a graphId.
Discovery Endpoints
Endpoint | Description |
| Full tool schemas, versions, and capabilities |
| Health check ( |
| MCP server auto-discovery manifest |
Authentication
Pass your Fodda API key as a Bearer token:
Authorization: Bearer fk_live_...In MCP request _meta:
{ "_meta": { "authorization": "Bearer fk_live_..." } }Configuration
Variable | Description | Default |
| HTTP server port (omit for stdio mode) | — |
| Upstream API base URL |
|
| HMAC signing secret | — |
| Comma-separated allowlist of Enterprise Tool scope |
|
| Environment ( |
|
| Comma-separated keys for simulation mode | — |
| Requests per minute per API key |
|
Build & Run
npm install
npm run build
# Stdio mode
npm start
# SSE mode
PORT=8080 npm startSelf-Hosting
Docker:
docker build -t fodda-mcp . && docker run -p 8080:8080 -e PORT=8080 fodda-mcpCloud Run:
./deploy_cloud_run.shKubernetes: See
deployment/k8s/Terraform: See
deployment/terraform/
MCP Registry
This server is published to the Official MCP Registry as io.github.piers-fawkes/fodda.
# Verify listing
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.piers-fawkes/fodda"License
Proprietary — fodda.ai