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 withfk_live_...
Use the email address associated with your Fodda account foruser_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 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/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
| Tool | Description | Deterministic |
|---|---|---|
list_graphs | Discover available knowledge graphs and their schemas | ✅ |
search_graph | Hybrid keyword + semantic search on a knowledge graph | ❌ |
get_neighbors | Traverse from seed nodes to discover related concepts | ✅ |
get_evidence | Source signals, articles, and provenance for a node | ✅ |
get_node | Retrieve metadata for a single node by ID | ✅ |
get_label_values | Discover valid values for a node label/category | ✅ |
discover_adjacent_trends | Find semantically similar trends to a given trend | ✅ |
All tools require userId and — except list_graphs — a graphId.
Discovery Endpoints
| Endpoint | Description |
|---|---|
GET /mcp/tools | Full tool schemas, versions, and capabilities |
GET /health | Health check ({ "status": "ok" }) |
GET /.well-known/mcp.json | 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 |
|---|---|---|
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 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