Pequod MCP

What pequod-mcp does

The pequod-mcp MCP server gives agents read-only access to two related data tasks: identifying securities and retrieving ETF portfolios. Its ETF tool returns the complete holdings reported in the latest available monthly Form N-PORT filing for a US-registered ETF, rather than a limited top-positions list. Each holding can include the name, ticker, ISIN, FIGI, LEI, share balance, US-dollar value, percentage of net assets, country, and currency.

The identifier tools cover several common inputs. lookup_cik maps a ticker to an SEC CIK and entity metadata such as legal name, SIC, listed exchanges, and fiscal year end. resolve_ticker applies exchange-code conventions and verifies the resulting Yahoo-style symbol. resolve_cusip also accepts SEDOL, while resolve_figi accepts a Bloomberg FIGI. Crosswalk responses distinguish successful verification from rejected mappings.

How it works

The pequod-mcp MCP server uses SEC EDGAR as the primary source for registrant data and ETF holdings. Holdings are parsed from N-PORT XML filings, and results include the relevant report date and EDGAR source URL so an agent can identify the filing period and cite the underlying document.

Crosswalks combine OpenFIGI mappings with SEC reference data. When a mapped symbol belongs to a US SEC registrant, the server compares the entity name from SEC data with the OpenFIGI security name. A substantial disagreement vetoes the result instead of returning an unchecked symbol. Symbols outside the SEC registry can be marked as verified by OpenFIGI. Yahoo exchange suffixes are generated as string conventions; the normal path does not contact Yahoo Finance.

Requests use a declared User-Agent, throttling, and an on-disk cache. EDGAR failures and parsing failures are returned as errors rather than being replaced with partial or alternate data.

Setup and configuration

Install the package with either uv pip install pequod-mcp or pip install pequod-mcp, then start it with pequod-mcp. The local transport is stdio, so configure the command in an MCP client that supports stdio. Claude Desktop can launch the command directly, and Claude Code can add it with claude mcp add.

An OpenFIGI API key is optional. Set API_OpenFIGI to receive higher rate limits; anonymous OpenFIGI access remains available subject to its limits. PEQUOD_CACHE_DIR changes the cache location, and LOG_LEVEL controls logging. Installing the [yahoo] extra and setting PEQUOD_YAHOO_VERIFY=1 enables optional live Yahoo quote enrichment for crosswalk results.

Tools and capabilities

• lookup_cik: retrieve SEC CIK and entity metadata from a ticker.
• resolve_ticker: convert a raw ticker and optional exchange code into a verified Yahoo-convention symbol.
• resolve_cusip: map a CUSIP or SEDOL to a symbol with cross-source checks.
• resolve_figi: map a Bloomberg FIGI to a symbol with cross-source checks.
• get_etf_holdings: retrieve all reported positions from the latest monthly US ETF N-PORT filing.

The server strips CUSIP fields from output. Returned identifiers include ticker, ISIN, FIGI, and LEI instead.

Limitations and notes

The pequod-mcp MCP server reports regulatory filing data, not live portfolio data. N-PORT filings are commonly one to two months behind the current date, so consumers should use report_date when interpreting results. The service has no degraded fallback: an unavailable EDGAR endpoint or an unreadable filing produces an error.

Results should be independently checked before investment decisions. OpenFIGI anonymous requests are rate-limited, and the optional Yahoo enrichment requires accepting Yahoo Finance terms of use. The package is licensed under Apache-2.0.