Fodda MCP Server

Name: Fodda Knowledge Graphs
Author: piers-fawkes

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 fk_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 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