Skip to content

nomina-xyz/nomina

v2.0.10MIT

Read-only markets research from public data: on-chain prices, Treasury yields, macro series, SEC filings, headlines.

GitHubOpen Website

Nomina

Markets research for agents from public data.

Five read-only tools, no API key, no account, no trading access:

  • search_markets — find symbols in Nomina's catalog (on-chain price feeds, Treasury tenors, macro series, SEC registrants) and recent headlines.
  • research_asset — latest value, period change, drawdown and volatility, dated history, and headlines for one symbol, over a named period or an exact date window.
  • compare_assets — align 2–6 symbols on shared observation dates, each in its own unit.
  • market_overview — period changes for BTC, ETH, SOL, gold, SPY, QQQ, EUR/USD, US 2y and 10y yields and CPI.
  • company_fundamentals — latest annual and quarterly financials and filings for an SEC registrant.

Data: Chainlink price feeds read from the Ethereum blockchain (crypto, FX, gold and silver, a few US equities/ETFs), the US Treasury yield curve, Bureau of Labor Statistics series, SEC EDGAR filings, and GDELT headlines: public-domain government statistics, public blockchain state, and openly released news records, each source's obligations documented and met in Data sources and limits.

Install

Hosted (no install): add https://mcp.nomina.io/mcp as a custom connector in Claude (Settings → Connectors → Add custom connector), or claude mcp add --transport http nomina https://mcp.nomina.io/mcp. First request after an idle period can take about a minute.

Claude Desktop: Settings → Extensions → Advanced settings → Extension Developer → Install Extension… → select Nomina.mcpb from a release (or build it yourself, see below). Requires a Claude Desktop release with MCPB v0.4 UV-runtime support and internet access on first install.

Any other MCP client (Claude Code, etc.): point it at this as a local stdio server:

{
  "mcpServers": {
    "nomina": {
      "command": "uv",
      "args": ["run", "--frozen", "--no-dev", "--directory", "/path/to/nomp", "server.py"]
    }
  }
}

Self-hosted (Streamable HTTP): docker run --rm -p 8000:8000 ghcr.io/nomina-xyz/nomina-mcp:2.0.6, then connect to http://localhost:8000/mcp. Details in the docs below.

Docs

Install guides, tool reference, privacy policy, and data-source limits: https://nomina-xyz.github.io/nomina-mcp/ — see especially Data sources and limits.

Privacy Policy

Full policy: https://nomina-xyz.github.io/nomina-mcp/privacy/ · Terms of use: https://nomina-xyz.github.io/nomina-mcp/terms/

  • Collection: when a tool runs, only its inputs — search terms, symbols, tickers, and the requested period or date window — are sent to the public sources that answer it: Ethereum JSON-RPC gateways (ethereum.publicnode.com, rpc.mevblocker.io) and Chainlink's feed directory, home.treasury.gov, api.bls.gov, www.sec.gov/data.sec.gov, and api.gdeltproject.org. Nothing else leaves the process.
  • Usage and storage: Nomina stores nothing. No accounts, no logs of requests or their contents, no telemetry. Source responses are held in memory (ten minutes for headlines up to a day for catalogs; immutable on-chain rounds for the process lifetime) to avoid repeat requests; nothing is written to disk.
  • Third parties: each source processes those requests under its own policy. Your MCP host handles the conversation under its own policy. Operators of a hosted instance may keep infrastructure connection logs; Nomina adds none.
  • Retention: none beyond the in-memory cache of the running process.
  • Contact: https://github.com/nomina-xyz/nomina-mcp/issues

Build from source

Requires uv.

uv sync
uv run python scripts/build_bundle.py   # writes dist/Nomina.mcpb
uv run pytest -q                        # 12 tests
uv run ruff check .

License

Code in this repository is MIT-licensed (see LICENSE).