Hub-Equity MCP server

<!-- mcp-name: com.hub-equity/hub-equity-mcp -->

hub-equity-mcp

Standardized XBRL financial data for LLM agents. A Model Context Protocol (MCP) server that exposes normalized financial facts from US SEC (EDGAR) and European ESEF filings to Claude Desktop, Cursor, and any MCP-aware client.

Hub-Equity is the first MCP server to serve standardized European ESEF filings alongside US SEC data through one consistent hub-concept vocabulary, so an agent can ask for REVENUE or TOTAL_ASSETS and get a comparable, source-linked value whether the issuer files with the SEC or under ESEF.

Maturity. The data engine and public REST API behind this connector run in

production and power Hub-Equity's own chat. This PyPI package is the newly

published client for that API; the surface is stable (SemVer 1.0), but as a

distributed package it is fresh, hence the Beta classifier.

Why

are mapped to a single set of standardized hub codes, so cross-issuer and cross-taxonomy comparison works out of the box.

• One vocabulary across two regimes. SEC us-gaap and ESEF ifrs-full concepts

provenance so an agent can cite rather than guess.

• Every number is source-linked. Facts carry their filing, period, and

idempotentHint=true, destructiveHint=false, openWorldHint=false per the MCP spec, so clients can reason about safety and caching without introspection.

• Read-only and closed-world. Every tool advertises readOnlyHint=true,

REST API (https://api.hub-equity.com) over HTTPS. It never ships or requires a Supabase or DB key.

• No database credentials. The published package talks only to the public

Install

pip install hub-equity-mcp

Requires Python 3.12 or newer.

Authentication and access

The server talks only to the public REST API. Two modes:

base tool set (entity search, normalized facts, time series, segments, screener, FX conversion, and more), capped at 60 requests per minute per IP.

• Anonymous (no key). Works out of the box, no account required. Gives the

(restatement diffs, calculation trees, cross-period compare, data-quality grades, validation checks, extension concepts). On the Pro plan a key also raises the limit to 300 requests per minute (1000 on Enterprise). A key is free to create from a Hub-Equity account (beta). Paid Pro and Enterprise plans exist but are not billed at this stage.

• With a hubq key (env var HUBEQUITYAPI_KEY). Unlocks the Pro tools

The published package never reaches the database directly, only the REST API.

Configure your client

Claude Desktop

Add to claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json, Windows: %APPDATA%\Claude\claudedesktopconfig.json):

{
  "mcpServers": {
    "hub-equity": {
      "command": "python",
      "args": ["-m", "hub_equity_mcp.server"],
      "env": {
        "HUBEQUITY_API_KEY": "hubq_live_..."
      }
    }
  }
}

Omit HUBEQUITYAPIKEY to run anonymously (60 requests per minute, base tools only).

Cursor

Add to .cursor/mcp.json (project root) or the global Cursor MCP settings:

{
  "mcpServers": {
    "hub-equity": {
      "command": "python",
      "args": ["-m", "hub_equity_mcp.server"],
      "env": {
        "HUBEQUITY_API_KEY": "hubq_live_..."
      }
    }
  }
}

Environment variables

rate limit. Absent means anonymous mode.

• HUBEQUITYAPIKEY (optional): a hubq_ key for premium tools and the higher

https:// is enforced whenever a key is set (the server refuses to send the Bearer key over plaintext to a non-loopback host).

• HUBEQUITYAPIURL (optional): defaults to https://api.hub-equity.com.

Capabilities

Tools

Shortened. The full README is on GitHub.