Fodda Brand Intelligence README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Fodda Brand Intelligence listing page.
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)
- Get your personal MCP URL at app.fodda.ai → Connections (format:
https://mcp.fodda.ai/c/<your-token>) - In Claude, go to Settings → Connectors → Add custom connector, paste the URL, and click Add
- Start chatting with your Fodda knowledge graphs
Note: Legacy URL query-string parameter authentication is deprecated and returns HTTP 401 with instructions. Get your fresh MCP URL or connect via OAuth at app.fodda.ai.
Claude Code (CLI)
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
| Tool | Description | Deterministic |
|---|---|---|
list_graphs | Discover available knowledge graphs, metadata, and routing instructions. | ✅ |
search_graph | Hybrid keyword + semantic search across curated graphs for trend clusters and evidence. | ❌ |
search_statistics | Search for specific quantitative metrics, indicators, and numeric data points. | ❌ |
search_insights | Search expert quotes, qualitative signals, and professional interpretations. | ❌ |
get_label_values | Discover valid values for a node label or category. | ✅ |
Traversal & Graph Operations
| Tool | Description | Deterministic |
|---|---|---|
get_neighbors | Traverse from seed nodes to discover related concept nodes and links. | ✅ |
get_node | Retrieve detailed metadata, properties, and attributes for a single node by ID. | ✅ |
get_evidence | Retrieve source signals, articles, citations, and provenance for a trend or node. | ✅ |
discover_adjacent_trends | Find semantically similar trends to a given trend node. | ✅ |
Intelligence Domains
| Tool | Description | Deterministic |
|---|---|---|
get_domain_intelligence | Search all PSFK curated domain graphs (retail, beauty, sports, fashion, consumer electronics, F&B) in parallel. | ❌ |
get_expert_intelligence | Query specialist industry graphs built by leading strategists and experts. | ❌ |
get_report_intelligence | Search institutional report insights from DHL, PwC, Delta, and other partners. | ❌ |
Earnings & Corporate Insights
| Tool | Description | Deterministic |
|---|---|---|
get_earnings_intelligence | Query management commentary, business guidance, and Q&A from company earnings calls. | ❌ |
get_earnings_divergence | Detect deflections, gaps, and divergence between analyst concerns and executive responses in earnings calls. | ❌ |
Brand & Ideation
| Tool | Description | Deterministic |
|---|---|---|
brand_tracker | Compile a comprehensive Brand Intelligence Profile across all knowledge graphs. | ❌ |
brainstorm_topic | Graph-powered brainstorm map discovering unexpected connections and adjacent territories. | ❌ |
Deep Research & Execution Agents
| Tool | Description | Deterministic |
|---|---|---|
deep_research_topic | Launch an autonomous research session combining graphs with live web search. | ❌ |
check_research_status | Check progress or retrieve the final narrative report of a deep research job. | ✅ |
get_supplemental_context | Fetch macro context from up to 10 institutional data sources in a single query. | ❌ |
check_supplemental_status | Retrieve output from a supplemental context job. | ✅ |
Synthetic Analyst & Visualization
| Tool | Description | Deterministic |
|---|---|---|
list_analysts | List available Synthetic Analyst expert personas. | ✅ |
consult_analyst | Engage a Synthetic Analyst persona to synthesize answers with specialized voice. | ❌ |
generate_visual | Generate 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
| Endpoint | Description |
|---|---|
GET /health | Health check ({ "status": "ok", "version": "..." }) |
POST /mcp | MCP 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:
The server also accepts the key via an X-API-Key: sk_live_... header.
In MCP request _meta:
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
| Variable | Description | Default |
|---|---|---|
PORT | HTTP server port | 8080 |
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
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.
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: privacy@fodda.ai.
See the full hosted Privacy Policy (last updated June 16, 2026) for the complete, authoritative terms.
Support
- Email: hello@fodda.ai
- Account & API keys: app.fodda.ai → Connections
- Documentation: fodda.ai
To report a security issue, email hello@fodda.ai with "SECURITY" in the subject line.
License
Proprietary — fodda.ai