Fodda Knowledge Graphs

io.github.piers-fawkes由 GitHub 帳號 piers-fawkes 發布v1.30.0更新於 Oct 24, 2026

Expert-curated knowledge graphs for AI agents — retail, beauty, sports, plus institutional data

發布方自己的服務:Fodda Brand Intelligence

概覽

AI 產生的概覽

讓助理以唯讀方式存取 Fodda 專家策展的知識圖譜,涵蓋零售、美妝、運動、財報與機構研究資料。

可以做什麼
提供約 30 個研究類工具,用來檢索與遍歷策展知識圖譜:圖譜探索、關鍵字與語意混合搜尋、統計指標與洞察搜尋、節點與鄰居遍歷,以及附來源出處的證據檢索。其他工具涵蓋產業與專家情報、機構報告資料、公司財報管理層說法與問答分歧分析、品牌剖析、腦力激盪、深度研究 session、合成分析師角色,以及 SVG 資料視覺化。另有面向研究的唯讀連接器版本,會隱藏管理與專家進駐類工具。
適用情境
適合助理需要策展的市場、趨勢、品牌或財報情報,而非開放網路結果的情境,例如趨勢研究、競品與品牌分析,或綜合機構報告。若你已在用 PSFK 風格的零售、美妝、運動或消費資料,並希望在對話中直接查詢,值得加入。
執行需求
以本機 npm 套件(fodda-mcp)透過 stdio 執行,或連線託管端點。需要 Fodda API 金鑰,透過 FODDA_API_KEY 或 Authorization Bearer 標頭提供;託管連接器也支援 OAuth。選用設定包括 FODDA_API_URL、PORT、FODDA_MCP_SECRET 與 NODE_ENV。需要 Node.js 及連線 Fodda API 的網路。
安裝前請注意
API 金鑰是可計費憑證,不要放入 URL 或日誌。查詢內容、存取的圖譜與時間戳會被記錄用於計費與防濫用,請求經 TLS 代理至 Fodda API。部分工具會啟動自主研究或補充脈絡工作,帳號類工具可變更偏好、個人資料與排程報告。試用額度有限,使用可能產生費用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Fodda Knowledge Graphs,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[Fodda Logo]

Fodda MCP Server

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

[MCP Registry] [npm] [Version] [License]


Quick Start

Claude (Web & Desktop — Scoped Research Connector)

Fodda provides a dedicated scoped endpoint optimized for research and expert advisory in Claude: https://mcp.fodda.ai/claude. It exposes a curated 30-tool suite (knowledge graphs, company earnings transcripts, macroeconomic data, synthetic analyst consultation, and commissioned deliverables) with all internal administrative and expert-onboarding mutators suppressed.

  1. In Claude, go to Settings → Connectors → Add custom connector
  2. Enter Name: Fodda and URL: https://mcp.fodda.ai/claude
  3. Authorize via Clerk OAuth (supports Google/LinkedIn SSO and email code) — your account is auto-provisioned with 100 free trial credits
  4. Start querying market intelligence, earnings divergence, and expert graphs

Alternatively, you can connect using your personal tokenized URL from app.fodda.ai → Connections (format: https://mcp.fodda.ai/c/<your-token>).

Note: Legacy URL query-string parameter authentication is deprecated and returns HTTP 401 with instructions. Connect via OAuth at https://mcp.fodda.ai/claude or use your tokenized connection URL.

Claude Code (CLI)

bash
# Connect to the curated Claude research connector via OAuth:claude mcp add --transport http fodda https://mcp.fodda.ai/claude
# Or with an API key:claude mcp add --transport http fodda https://mcp.fodda.ai/claude \  --header "Authorization: Bearer sk_live_..."

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

ToolDescriptionDeterministic
list_graphsDiscover available knowledge graphs, metadata, and routing instructions.✅
search_graphHybrid keyword + semantic search across curated graphs for trend clusters and evidence.❌
search_statisticsSearch for specific quantitative metrics, indicators, and numeric data points.❌
search_insightsSearch expert quotes, qualitative signals, and professional interpretations.❌
get_label_valuesDiscover valid values for a node label or category.✅

Traversal & Graph Operations

ToolDescriptionDeterministic
get_neighborsTraverse from seed nodes to discover related concept nodes and links.✅
get_nodeRetrieve detailed metadata, properties, and attributes for a single node by ID.✅
get_evidenceRetrieve source signals, articles, citations, and provenance for a trend or node.✅
discover_adjacent_trendsFind semantically similar trends to a given trend node.✅

Intelligence Domains

ToolDescriptionDeterministic
get_domain_intelligenceSearch all PSFK curated domain graphs (retail, beauty, sports, fashion, consumer electronics, F&B) in parallel.❌
get_expert_intelligenceQuery specialist industry graphs built by leading strategists and experts.❌
get_report_intelligenceSearch institutional report insights from DHL, PwC, Delta, and other partners.❌

Earnings & Corporate Insights

ToolDescriptionDeterministic
get_earnings_intelligenceQuery management commentary, business guidance, and Q&A from company earnings calls.❌
get_earnings_divergenceDetect deflections, gaps, and divergence between analyst concerns and executive responses in earnings calls.❌

Brand & Ideation

ToolDescriptionDeterministic
brand_trackerCompile a comprehensive Brand Intelligence Profile across all knowledge graphs.❌
brainstorm_topicGraph-powered brainstorm map discovering unexpected connections and adjacent territories.❌

Deep Research & Execution Agents

ToolDescriptionDeterministic
deep_research_topicLaunch an autonomous research session combining graphs with live web search.❌
check_research_statusCheck progress or retrieve the final narrative report of a deep research job.✅
get_supplemental_contextFetch macro context from up to 10 institutional data sources in a single query.❌
check_supplemental_statusRetrieve output from a supplemental context job.✅
generate_comms_plan2026 Strategy-to-Activation Comms & Retail Media Plan with T1-T5 tasks, 3-layer shopper audience cards, digital shelf intelligence, and activation manifest.❌

Synthetic Analyst & Visualization

ToolDescriptionDeterministic
list_analystsList available Synthetic Analyst expert personas.✅
consult_analystEngage a Synthetic Analyst persona to synthesize answers with specialized voice.❌
generate_visualGenerate 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

EndpointDescription
GET /healthHealth check ({ "status": "ok", "version": "..." })
POST /mcpMCP 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:

Authorization: Bearer sk_live_...

The server also accepts the key via an X-API-Key: sk_live_... header.

In MCP request _meta:

json
{ "_meta": { "authorization": "Bearer sk_live_..." } }

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

VariableDescriptionDefault
PORTHTTP server port8080
FODDA_API_URLUpstream API base URLhttps://api.fodda.ai
FODDA_MCP_SECRETHMAC signing secret for API requests—
NODE_ENVEnvironment (development / production)production

Build & Run

bash
npm installnpm run buildnpm 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 ai.fodda/mcp-server.

bash
# Verify listingcurl "https://registry.modelcontextprotocol.io/v0.1/servers?search=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: [email protected].

See the full hosted Privacy Policy (last updated June 16, 2026) for the complete, authoritative terms.


Support

To report a security issue, email [email protected] with "SECURITY" in the subject line.


License

Proprietary — fodda.ai

來源:README.md,提交 f0381ed

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.30.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Fodda 整合