# Fodda Earnings Intelligence (remote · mcp.fodda.ai)

Cross-company earnings trends & executive divergence with citable sources.

- Trust score: 70/100 (medium)
- Change this week: +15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.fodda.ai`: 70/100 (this document), [markdown](https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence.md), [page](https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence)

## Channel facts

- Endpoint: `https://mcp.fodda.ai/earnings-intelligence`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.33.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 61/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 7216 tokens (~451/item across 16 items; 13 tools + 3 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http ai-fodda-earnings-intelligence https://mcp.fodda.ai/earnings-intelligence
```

### Codex

```toml
[mcp_servers.ai-fodda-earnings-intelligence]
url = "https://mcp.fodda.ai/earnings-intelligence"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-fodda-earnings-intelligence": {
      "type": "remote",
      "url": "https://mcp.fodda.ai/earnings-intelligence",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-fodda-earnings-intelligence --url https://mcp.fodda.ai/earnings-intelligence --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-fodda-earnings-intelligence:
    url: "https://mcp.fodda.ai/earnings-intelligence"
```

### Other

```json
{
  "mcpServers": {
    "ai-fodda-earnings-intelligence": {
      "type": "http",
      "url": "https://mcp.fodda.ai/earnings-intelligence"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 70, +2)

- [security] The server rewrote its instructions, which are the text every model session reads

### 2026-08-01 (score 68, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 64, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 64, +9)

- [security improvement] Transport: fail → pass
- [security] The server rewrote its instructions, which are the text every model session reads
- [functional improvement] Schema quality: 538 → 449
- [functional improvement] Stability: unverified → 0.03
- [functional] Schema quality: good → fair
- [functional] New tool “get_capabilities”
- [functional] New tool “get_validated_trends”

### 2026-07-27 (score 55)

First indexed and scored.

## MCP tools (13)

### `get_my_account` (~74 tokens)

Check the current user's account status: API call balance, plan, enabled/disabled graphs, and profile info. Use when the user asks "how many API calls do I have?", "what plan am I on?", "what graphs can I access?", or similar account questions. Returns live data — not cached from session start.

### `list_graphs` (~108 tokens)

List all knowledge graphs the user can access — IDs, descriptions, authors, sectors, signal counts. Use FIRST in any session to discover available sources before searching. Returns graph metadata needed for graphId parameters in other tools. Deprecated: waldo, psfk (use retail/tech/food/travel/fashion/beauty/sports instead).

Input parameters:

- `userId` (string): Optional user identifier. Authenticated users are identified automatically via API key. For trial users, this helps track usage.

### `get_capabilities` (~58 tokens)

Returns Fodda's main capabilities / features / offerings / products / services / tools and what they cost. Call this for any question about what Fodda can do or what's available.

Input parameters:

- `userId` (string): Optional user identifier.

### `search_graph` (~428 tokens)

Find trends, signals, and expert insights across 100+ curated knowledge graphs covering retail, beauty, tech, food, travel, sports, and 30+ specialist domains. Returns trend data with cited evidence, source attribution, and lifecycle stage (emerging/building/mature/fading) — not generic web summaries. If graphId is omitted, searches ALL accessible graphs in parallel (recommended default). Use for market trends, competitor analysis, innovation signals, consumer behavior, cultural shifts, or any topic where curated expert intelligence outperforms web search.

Input parameters:

- `graphId` (string): Optional graph ID. If omitted, searches ALL accessible graphs. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-tren…
- `include_evidence` (boolean): If true, batch-fetch supporting evidence articles inline with results. Default: true.
- `limit` (number): Maximum number of results (default 10, max 50)
- `mode` (string): Execution mode: "research" for topic research (15 API calls), "compare" for upload & compare intelligence (20 API calls). Defaults to "research".
- `query` (string, required): The search query. Location terms are auto-detected and used to filter results geographically.
- `skip_skills` (boolean): If true, skip applying any enabled skills (Paralogy, Igloo, etc.) for this query only. Use when the user says "without skills", "skip Paralogy", or "just the raw results". Default: false.
- `use_semantic` (boolean): Whether to use semantic search (default true)
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_neighbors` (~406 tokens)

Discover what's connected to a specific trend — related brands, technologies, locations, and cross-domain links that search alone wouldn't surface. Returns curated editorial connections between trends that web search cannot provide. Use after search_graph to map the territory around a trend, find which brands are connected, or understand cross-domain relationships. Requires node_id from a prior search_graph result.

Input parameters:

- `depth` (number): Traversal depth (default 1, max 2)
- `direction` (string): Traversal direction: 'out' (default) follows outgoing edges, 'in' follows incoming edges
- `graphId` (string, required): The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'au…
- `limit` (number): Maximum results (default 50)
- `relationship_types` (array): Filter by relationship types: 'EVIDENCED_BY', 'RELATED_TO', 'SEMANTICALLY_SIMILAR', 'ASSOCIATED_BRAND', 'MENTIONS_BRAND', 'IN_LOCATION'
- `seed_node_ids` (array, required): Array of node IDs to start traversal from. MUST be actual node_id values from a prior search_graph result (e.g. ["2507.0"]). Node IDs are NOT sequential integers — do NOT guess or invent IDs like "1"…
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_evidence` (~315 tokens)

Get the source articles, case studies, and statistics behind a specific trend — with full citations and publisher attribution. Each item includes source URL, location, brand names, publication date, category, and a formatted citation. Use after search_graph when you need the supporting proof behind a trend. This is a direct lookup by trend ID — not a text search tool.

Input parameters:

- `for_node_id` (string, required): The node_id from a prior search_graph result (e.g. '2507.0'). MUST come from the search result's node_id field. Node IDs are NOT sequential integers — do NOT guess or invent IDs like '1', '2', '3'. D…
- `graphId` (string, required): The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'au…
- `top_k` (number): Number of evidence items to return (default 5)
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_node` (~282 tokens)

Get the full profile of a specific trend — detailed description, lifecycle stage (emerging/building/mature), signal strength, geographic scope, and all properties. Use when you need deeper detail on a single trend after search_graph returned a summary. Requires node_id from a prior search_graph result.

Input parameters:

- `graphId` (string, required): The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'au…
- `nodeId` (string, required): The node_id from a prior search_graph result (e.g. '2507.0'). MUST come from the search result's node_id field. Node IDs are NOT sequential integers — do NOT guess or invent IDs like '1', '2', '3'. D…
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_label_values` (~297 tokens)

List all brands, locations, technologies, audiences, or trends within a specific knowledge graph. Use to explore what a graph contains — e.g., "what brands are in the retail graph?" or "what locations does the fashion graph cover?". To get a complete list of every trend in a graph, call with label="Trend" — this returns the full deterministic list, useful for industry-report graphs where search may return partial results.

Input parameters:

- `graphId` (string, required): The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'au…
- `label` (string, required): The label to fetch values for (e.g., 'Brand', 'Location', 'Technology', 'Audience', 'RetailerType', 'Trend')
- `property` (string): Optional property to return values for. Defaults vary by label.
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_earnings_intelligence` (~331 tokens)

Cross-company thematic earnings intelligence from the knowledge graph and web sources. Use for multi-company comparisons ("what are hotel companies saying about labor costs?"), industry-level queries, or sector filters. For single-brand earnings, brand_tracker includes earnings automatically. For per-ticker structured analysis (analyst concerns, activity breakdown, validated consumer trends), use get_company_earnings instead — it reads the canonical truth layer. Results may include "knowledge_graph" or "web_supplemental" provenance. Uses 5 tokens ($2.50 via SPT).

Input parameters:

- `brand` (string): Brand name for fuzzy matching (e.g., 'Nike', 'Marriott')
- `dateFrom` (string): ISO date range start (e.g., '2025-01-01')
- `dateTo` (string): ISO date range end (e.g., '2026-06-01')
- `industry` (string): Industry filter (e.g., 'hotels', 'sportswear', 'consumer electronics')
- `limit` (integer): Max results to return (default 20, max 50)
- `search` (string): Free text search in earnings summaries (e.g., 'labor costs', 'tariff guidance', 'AI investment')
- `sector` (string): Sector filter (e.g., 'retail', 'technology', 'travel')
- `ticker` (string): Company stock ticker (e.g., 'NKE', 'LVMUY', 'HLT'). At least one filter required.
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_earnings_divergence` (~246 tokens)

Cross-company analyst-management divergence detection from the knowledge graph (legacy-thematic). Surfaces where executives are deflecting, reframing, or avoiding specific topics — the gap between what analysts press on and how management responds. Use for "where are executives deflecting?" or "divergence in [sector] earnings." For per-ticker deflection signals, use get_company_earnings with view=qa and filter by response_directness. Uses 5 tokens ($2.50 via SPT).

Input parameters:

- `dateFrom` (string): ISO date range start
- `dateTo` (string): ISO date range end
- `industry` (string): Industry filter (e.g., 'hotels', 'sportswear', 'luxury')
- `limit` (integer): Max results to return (default 10, max 25)
- `search` (string): Free text search (e.g., 'tariffs', 'AI capex', 'margin erosion')
- `sector` (string): Sector filter (e.g., 'retail', 'technology', 'travel')
- `userId` (string): Optional user identifier for trial usage tracking.

### `get_company_earnings` (~423 tokens)

The canonical per-ticker earnings source. Returns the full truth-layer record for covered tickers (517 consumer-sector companies) — analyst concerns, sentiment labels, strategic activity (marketing/retail/technology/sustainability), CEO intelligence, and validated consumer trends from Fodda's quarterly analysis pipeline. Falls back to web-backfill for uncovered tickers. Uses 0–15 API calls depending on mode/view (coverage is free, snapshot/history = 10, qa = 5, compare = 15). Use this for company-specific data. Use get_earnings_intelligence for cross-company thematic comparisons.

Input parameters:

- `analyst` (string): Analyst name filter for qa view.
- `metrics` (string): Comma-separated metric names for history view (e.g. swot_total,ceo_sentiment). Defaults to all.
- `mode` (string): Execution mode (alias for view): snapshot (10 API calls), history (10 API calls), qa (5 API calls), compare (15 API calls), guidance (10 API calls), coverage (free).
- `period` (string): Quarter filter (e.g. Q1-2026). Defaults to latest quarter.
- `sector` (string): Sector filter for guidance view.
- `ticker` (string): Company ticker symbol (e.g. NKE, LULU, ONON). Required for snapshot, history, and qa views.
- `tickers` (string): Comma-separated ticker symbols for compare view (2-5 tickers). Only used when view=compare.
- `userId` (string): Optional user identifier for trial usage tracking.
- `view` (string): snapshot: full quarterly record with analyst concerns, sentiment, activity, validated trends (10 API calls). history: narrative timeline across quarters (10 API calls). qa: per-analyst Q&A entries wi…

### `get_validated_trends` (~158 tokens)

Returns market-validated consumer trends from corporate earnings reports cross-validated by Fodda's analysis pipeline. Connects earnings commentary (analyst concerns, CEO statements) with consumer trend signals.

Input parameters:

- `limit` (integer): Max results to return (default 20, max 50)
- `search` (string): Free text search in validated trends (e.g. 'resale', 'inventory', 'pricing').
- `sector` (string): Filter by sector (e.g. 'retail', 'sportswear', 'beauty').
- `ticker` (string): Filter by company ticker symbol (e.g. 'NKE', 'LULU').
- `userId` (string): Optional user identifier for trial usage tracking.

### `generate_visual` (~247 tokens)

Create a presentation-ready data visualization from research findings. Available chart types: "cultural_shifts" (From→To transitions), "competitive_compass" (brands on 2 axes), "trend_constellation" (network of related trends), "implication_ladder" (Signal→Trend→So What→Do What), "innovation_pathway" (Now→Near-Term→Future), "opportunity_map" (2×2 white space analysis). Returns a branded SVG that renders directly in the chat.

Input parameters:

- `chart_type` (string, required): The type of visualization to generate
- `data` (string, required): JSON string containing the chart data. Structure depends on chart_type. cultural_shifts: {shifts:[{from,to}]}. competitive_compass: {brands:[{name,x,y}], axes:{left,right,top,bottom}}. trend_constell…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 68
- 2026-08-01: 68
- 2026-07-31: 64
- 2026-07-30: 65
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 55

## Links

- Remote endpoint: https://mcp.fodda.ai/earnings-intelligence
- Authorisation metadata: https://mcp.fodda.ai/.well-known/oauth-protected-resource/earnings-intelligence
- Repository: https://github.com/piers-fawkes/fodda-mcp
- Website: https://www.fodda.ai/
- Changelog RSS feed: https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ai-fodda-earnings-intelligence/earnings-intelligence