English Français العربية

pyeconomics

Official registry Finance and payments

Tested, cited economics and finance models and data, with a provenance manifest per result.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package pyeconomics
Claude Code 
claude mcp add pyeconomics -- uvx pyeconomics==1.0.0b1 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pyeconomics": {
            "command": "uvx",
            "args": [
                "pyeconomics==1.0.0b1",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. pyeconomics
  2. pyeconomics 0.2.x
  3. Not to be confused with
  4. Contributing and security
  5. Licence
  6. Notices

pyeconomics

Status: 1.0.0b1 is a beta pre-release on PyPI. Install explicitly with pip install --pre pyeconomics==1.0.0b1 (Python 3.12 or later). Plain pip install pyeconomics still installs 0.2.6, the stable release. Pre-releases carry no stability promise until 1.0.0.

pyeconomics provides 50 tested, cited economics and finance model families across 13 domains: foundations, fixed income, derivatives, international, equity, corporate, accounting, portfolio, performance, risk, econometrics, macroeconomics and asset pricing. The data platform adds 31 providers, 171 catalog concepts and live bindings with real-time vintages. Every model is served identically through the Python API, the pyeconomics command line, the REST API (pyeconomics serve), the MCP server (pyeconomics mcp) and tabular or reproducibility-bundle exports. Typed inputs declare units and bounds; every result carries a reproducible provenance manifest. Rates and percentages are decimals: 0.05 means 5%.

Use the 1.0 documentation preview for formulas, assumptions and examples, and the beta release notes for the shipped surfaces and known limitations. See the CLI guide, REST API guide, MCP server guide, exports guide, AI narrative guide, data guide and keys guide to get started. Install optional econometrics, plotting, REST API and MCP support with pip install --pre "pyeconomics[econometrics,plot,server,mcp]==1.0.0b1", or run the MCP server directly with uvx --from "pyeconomics[mcp]==1.0.0b1" pyeconomics mcp.

This beta replaces the 0.2.x API and adds the command line, exports and reproducibility bundles, REST API, MCP server and optional AI narrative on top of the model engine and data platform. The web app arrives in Phase 5; the project roadmap and architecture decisions record that plan. Keep legacy workloads in a separate environment.

pyeconomics 0.2.x

0.2.6 is the current stable release of the 0.2.x line: four monetary-policy rules over FRED data.

  • It is MIT-licensed. Its source lives on the legacy/0.2.x branch, and its documentation at https://pyeconomics.readthedocs.io/.
  • It receives security fixes only, and reaches end of life when 1.0.0 is released. Pins such as pyeconomics<1 keep working.
  • 0.2.0 to 0.2.5 log the FRED API key at DEBUG level. Upgrade to 0.2.6 and rotate any key those versions used: see advisory GHSA-j6rp-vwwv-jrr8.

Not to be confused with

This project is not davidrpugh/pyeconomics (computational-economics course code from 2013–14) or pyecon.org (a site teaching Python for economics). The three share only the name.

Contributing and security

Licence

From 1.0, pyeconomics is licensed under the Apache License 2.0; see also NOTICE. Releases up to and including 0.2.x remain MIT-licensed.

Notices

As is; not investment advice. pyeconomics is for educational and informational use only, and is not registered with any regulator.

CFA® and Chartered Financial Analyst® are trademarks owned by CFA Institute. pyeconomics is not affiliated with, endorsed by, or a Prep Provider of CFA Institute.

Frequently asked questions

What is pyeconomics?

Tested, cited economics and finance models and data, with a provenance manifest per result.

How do I install pyeconomics?

It runs on your machine. In Claude Code: claude mcp add pyeconomics -- uvx pyeconomics==1.0.0b1 mcp. For other clients, paste the JSON configuration from this page into their MCP settings.

Does pyeconomics need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is pyeconomics open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains pyeconomics?

It is published by pyeconomics-dev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.