# pyeconomics

> pyeconomics is an open-source MCP server for finance and payments. MCP server giving AI assistants cited economics and finance models with provenance. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted, macOS, Windows, Linux
- **Website:** https://pyeconomics.readthedocs.io/en/main/mcp.html
- **Repository:** https://github.com/pyeconomics-dev/pyeconomics
- **MCP Registry name:** io.github.pyeconomics-dev/pyeconomics
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes pyeconomics as a Python library of 50 economics and finance model families across 13 domains, with a data layer covering 31 providers. The MCP server exposes that same model set to an AI assistant through five tools rather than one tool per model, so the assistant can find a model, read its inputs and run it.

Each run returns the same canonical JSON that the Python API produces, along with the manifest of every data source it read. Sources whose licence terms do not permit reaching a language model are filtered out before results leave the server, and an opt-in is required before unclear-terms data is passed through. Sixteen widely used models also get dedicated tools.

It suits developers and analysts who want an assistant to run valuation, fixed income, risk or portfolio calculations and cite the data behind them. Per the docs, it runs over stdio for desktop clients or as Streamable HTTP, and the README notes it is for educational and informational use, not investment advice.

## Features

- **Unified model tools:** Five generic tools reach every registered model and data source, and sixteen common models have their own named tools.
- **Reproducible results:** Each run returns canonical JSON matching the Python API along with a one-line summary.
- **Source provenance manifests:** Results carry the manifest of each data source read, plus the attributions that must be shown.
- **Language-model data gating:** Sources whose terms forbid use with a language model are skipped, and unclear sources need explicit opt-in.
- **Stdio and HTTP transports:** Runs over standard input and output for desktop clients or as a Streamable HTTP server on localhost.

## Good for

- Calculating bond duration, yields or option Greeks inside an AI assistant
- Running discounted cash flow or dividend valuation with cited inputs
- Pulling macroeconomic or market series with their required attributions
- Comparing portfolio risk metrics such as Sharpe ratio or value-at-risk
- Checking which economic data sources are allowed for use with an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add pyeconomics -- uvx pyeconomics
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pyeconomics": {
      "command": "uvx",
      "args": [
        "pyeconomics"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pyeconomics": {
      "command": "uvx",
      "args": [
        "pyeconomics"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pyeconomics": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pyeconomics"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pyeconomics": {
      "command": "uvx",
      "args": [
        "pyeconomics"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pyeconomics": {
      "command": "uvx",
      "args": [
        "pyeconomics"
      ]
    }
  }
}
```

## Tools

- `search_models`: Searches models by words in their ids, titles, tags, domains and summaries, or lists a domain's models.
- `describe_model`: Returns a model's specification, input and output JSON Schemas and model card.
- `run_model`: Runs any model on its inputs, optionally binding inputs to the data catalog.
- `get_series`: Returns a catalog concept's or provider series' data with source records and attributions.
- `list_sources`: Lists every data provider with licence class, LLM-use class and attribution terms.

## FAQ

### How do I install the server?

The docs give the command uvx --prerelease allow --from "pyeconomics[mcp]" pyeconomics mcp, or pip install --pre "pyeconomics[mcp]" followed by the same command.

### Does the server run code or read files?

The docs say no tool executes code, fetches a URL you name, reads or writes a file, or returns an API key.

### Is it stable?

The README says 1.0.0b1 is a beta pre-release with no stability promise until 1.0.0.

### Can an assistant access data that forbids LLM use?

Forbidden sources are skipped and unclear ones need an opt-in set by the user in configuration, which the assistant cannot change.

### Is pyeconomics free?

Yes. pyeconomics is open source, so you can use and self-host it for free.

### How do I add pyeconomics to Claude Code?

Run this command in your terminal: claude mcp add pyeconomics -- uvx pyeconomics

### What are the best alternatives to pyeconomics?

The closest alternatives to pyeconomics are QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API, QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API, meirinho.com.br, leitura para agentes, Llmmcp and awesome-mcp-servers.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API](https://ai-powered.com/mcp/quantledger-73-engine-cpa-gaap-irc-tax-credit-and-sec-10-k-a-2): QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API is a freemium MCP server for finance and payments.
- [QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API](https://ai-powered.com/mcp/quantledger-73-engine-cpa-gaap-irc-tax-credit-and-sec-10-k-a): QuantLedger 73-Engine CPA, GAAP, IRC Tax, Credit & SEC 10-K API is a freemium MCP server for finance and payments.
- [meirinho.com.br, leitura para agentes](https://ai-powered.com/mcp/meirinho-com-br-leitura-para-agentes): meirinho.com.br, leitura para agentes is an open-source MCP server for developer tools.
- [Llmmcp](https://ai-powered.com/mcp/llmmcp): Llmmcp is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [python-sdk](https://ai-powered.com/mcp/python-sdk): python-sdk is an open-source MCP server for developer tools.
- [ATLAS Explain](https://ai-powered.com/mcp/atlas-explain): ATLAS Explain is a free MCP server for finance and payments.
- [Market Data: Options, Screeners, Economic Calendar (Yugenox)](https://ai-powered.com/mcp/market-data-options-screeners-economic-calendar-yugenox): Market Data: Options, Screeners, Economic Calendar (Yugenox) is a paid MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pyeconomics
