# Hub-Equity MCP

> Hub-Equity MCP is a freemium MCP server for finance and payments. Standardized SEC and ESEF filing data for agents, with the source filing on every fact. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://hub-equity.com/mcp
- **Repository:** https://github.com/hub-equity/hub-equity-mcp
- **MCP Registry name:** com.hub-equity/hub-equity-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/hub-equity-mcp
