Skip to content
MCP server

Hub-Equity MCP

Standardized SEC and ESEF filing data for agents, with the source filing on every fact

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
2.0.0
Listing updated
2 days ago

About Hub-Equity MCP

Hub-Equity MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Hub-Equity maps US-GAAP and IFRS concepts onto one vocabulary, so an agent can ask for REVENUE or TOTAL_ASSETS and get a comparable value whether the issuer files with the SEC or under ESEF. The server is a thin Python package that calls Hub-Equity's public REST API; it never touches the database directly.

What sets it apart is the forensic side. Facts carry a restatement flag, and one tool surfaces silent restatements, where a later filing reprinted a figure differently with no amendment filed. Another returns the XBRL calculation linkbase with the filer's weights beside corrected ones. All tools are marked read-only, idempotent and non-destructive.

A free API key is required and opens entity lookup, facts and the base tools; paid plans open the premium tools such as restatement diffs, calculation trees and cross-issuer comparison. The site says it covers more than 12,500 SEC and ESEF issuers.

Install

Run in a terminal

claude mcp add hub-equity-mcp --env HUBEQUITY_API_KEY='<HUBEQUITY_API_KEY>' -- uvx hub-equity-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hub-equity-mcp": {
      "command": "uvx",
      "args": [
        "hub-equity-mcp"
      ],
      "env": {
        "HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hub-equity-mcp": {
      "command": "uvx",
      "args": [
        "hub-equity-mcp"
      ],
      "env": {
        "HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "hub-equity-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hub-equity-mcp"
      ],
      "env": {
        "HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hub-equity-mcp": {
      "command": "uvx",
      "args": [
        "hub-equity-mcp"
      ],
      "env": {
        "HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hub-equity-mcp": {
      "command": "uvx",
      "args": [
        "hub-equity-mcp"
      ],
      "env": {
        "HUBEQUITY_API_KEY": "<HUBEQUITY_API_KEY>"
      }
    }
  }
}

Configuration

  • HUBEQUITY_API_KEYhubq_ API key, required. A Free key (https://hub-equity.com/settings/api-keys) opens entity lookup, facts and the base tools; a paid plan opens the premium tools and raises the rate limit.Required

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

find_entity
Resolves a ticker, ticker.MIC, CIK or name to a canonical entity_id.
get_fact
Returns one concept for one period with its source filing and restatement flag.
get_fact_decomposition
Returns the XBRL calculation linkbase per link role.
get_silent_restatements
Lists figures reprinted differently in later filings with no amendment.
get_segments
Lists the XBRL axes an issuer reports, such as geography, segment and product.

What it does

One concept vocabulary
US-GAAP and IFRS concepts map to shared codes for cross-issuer comparison.
Filing behind every number
Each fact carries its source filing, period and provenance.
Silent restatement detection
Finds figures reprinted differently in later filings with no amendment.
Calculation tree
Shows the filer's linkbase weights next to corrected ones.
Entity resolution
Resolves tickers, CIKs or names to one canonical entity.
Read-only tools
Every tool advertises read-only and non-destructive hints.

Good for

  • Pull revenue for a company and cite the source filing
  • Compare an American and a European issuer on the same concept
  • Check whether a reported figure was quietly restated
  • Break a reported total into its XBRL components
  • Explore segment reporting by geography or product

Pricing

Freemium

Free key with daily and monthly caps; paid plans (Builder, Team, Enterprise) add premium tools

Prices change. Check hub-equity.com before you buy.

Hub-Equity MCP FAQ

Do I need an API key?

Yes. A free key from hub-equity.com needs no card and unlocks the base tools; without it every tool replies with the link to create one.

What are the free limits?

The pricing page lists 120 requests a minute, 200 calls a day and 5,000 a month.

Which tools need a paid plan?

Restatement diffs, calculation trees, cross-period and cross-issuer comparison, validation checks and extension concepts.

What does it need to run?

Python 3.12 or newer; start it with pipx run hub-equity-mcp or uvx hub-equity-mcp.

Is Hub-Equity MCP free?

Hub-Equity MCP has a free plan, with paid plans for more usage or features.

How do I add Hub-Equity MCP to Claude Code?

Run this command in your terminal: claude mcp add hub-equity-mcp --env HUBEQUITY_API_KEY='<HUBEQUITY_API_KEY>' -- uvx hub-equity-mcp

What are the best alternatives to Hub-Equity MCP?

The closest alternatives to Hub-Equity MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Hub-Equity MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments