Fodda Earnings Intelligence MCP server

# 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)

1. Get your personal MCP URL at app.fodda.ai → Account → MCP Integration (format: https://mcp.fodda.ai/c/)
2. In Claude, go to Settings → Connectors → Add custom connector, paste the URL, and click Add
3. Start chatting with your Fodda knowledge graphs

Note: legacy ?apikey= or ?userid= query string URLs are deprecated and return HTTP 401 with explicit instructions (Fodda: this connection URL is outdated. Get your new MCP URL at https://app.fodda.ai...). Get your fresh MCP URL or connect via OAuth at app.fodda.ai.

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 (Responses API — Recommended)

Use OpenAI's native MCP support — no function definitions needed:

from openai import OpenAI
client = OpenAI()

resp = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "fodda",
        "server_description": "Expert-curated knowledge graphs for retail, beauty, sports trends and earnings intelligence.",
        "server_url": "https://mcp.fodda.ai/mcp",
        "authorization": "Bearer YOUR_API_KEY",
        "require_approval": "never",
    }],
    input="What are the top emerging retail trends?",
)
print(resp.output_text)

import OpenAI from "openai";
const client = new OpenAI();

const resp = await client.responses.create({
  model: "gpt-5",
  tools: [{
    type: "mcp",
    server_label: "fodda",
    server_description: "Expert-curated knowledge graphs for retail, beauty, sports trends and earnings intelligence.",
    server_url: "https://mcp.fodda.ai/mcp",
    authorization: "Bearer YOUR_API_KEY",
    require_approval: "never",
  }],
  input: "What are the top emerging retail trends?",
});
console.log(resp.output_text);

Tip: To reduce latency with 30+ tools, use allowed_tools to filter:

"allowedtools": ["searchgraph", "searchstatistics", "brandtracker"]

Legacy: If you're using chat.completions.create() with function calling, define a custom function that calls the Fodda REST API. See fodda.ai/connect for details.

Connect from ChatGPT (ChatGPT Apps Directory)

To connect Fodda to ChatGPT (Apps Directory listing or a custom MCP connection):

• Server URL: https://mcp.fodda.ai/chatgpt
• Authentication: OAuth 2.1 (PKCE S256, Dynamic Client Registration) — authorization server https://clerk.fodda.ai (metadata at https://clerk.fodda.ai/.well-known/oauth-authorization-server)
• Resource metadata discovery: https://mcp.fodda.ai/.well-known/oauth-protected-resource/chatgpt
• Curated tool profile: 24 tools covering trends, brand tracking, earnings intelligence, expert intelligence, and visual generation.

Shortened. The full README is on GitHub.