mcp · cli · python

Run a model your way.

Use the hosted tools in a supported AI client, install the shared CLI, or call the Python packages directly. Start with the quickest route that gives you the control you need. The public MCP endpoint itself needs no PolicyEngine account or API key; AI-client plan and workspace permissions still apply.

hosted

Connect in three steps.

The MCP endpoint is public; client eligibility still applies.

1

Copy the server URL

https://policyengine--policyengine-macro-mcp-serve.modal.run/mcp
2

Add a Claude connector

Open Settings → Connectors, add a custom connector, and paste the URL.

3

Ask a policy question

Try a US rate shock, a UK forecast, or a household reform in either country.

Terminal setup
claude mcp add --transport http policyengine-macro https://policyengine--policyengine-macro-mcp-serve.modal.run/mcp
terminal

Run the shared CLI.

Install once, then choose a model command.

pip install "policyengine-macro[models] @ git+https://github.com/PolicyEngine/macro#subdirectory=integration"
US rate shockpe-macro frbus-shock --var rffintay_aerr --shock 1.0
UK forecastpe-macro forecast
Household calculationpe-macro household --country us

View every CLI command →

python

Use a model package directly.

Choose a model for its install and API reference.

local

Long-run reform effects

Model work, saving, capital, and public finances over decades.

Open OG-UK setup