MCP Servers

Fodda

Expert-curated knowledge graphs for AI agents covering retail, beauty, sports, and other industries. Query structured insights, explore relationships, retrieve evidence, and generate macro overviews powered by PSFK's proprietary research.

README

Fodda MCP Server

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

</div>

Quick Start

Claude Code

claude mcp add --transport sse fodda https://mcp.fodda.ai/sse \
  --header "Authorization: Bearer YOUR_API_KEY"

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
`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	✅
`psfk_overview`	Structured macro overview across industries and sectors	❌

All tools require userId and — except psfk_overview — 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`	SSE server port (omit for stdio mode)	—
`FODDA_API_URL`	Upstream API base URL	`https://api.fodda.ai`
`FODDA_MCP_SECRET`	HMAC signing secret	—
`NODE_ENV`	Environment (`development` / `production`)	`production`
`INTERNAL_TEST_KEYS`	Comma-separated keys for simulation mode	—
`RATE_LIMIT_RPM`	Requests per minute per API key	`60`

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

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured