@economicagents/mcp

MCP (Model Context Protocol) server for AEP: budget tools, intent resolution, analytics, fleet, and economic relationship readouts. Use with Cursor, Claude Desktop, or any MCP-capable client.

Install

pnpm add @economicagents/mcp

From a local clone of economicagents/AEP: cd packages/mcp && pnpm run build.

Tools

| Tool | Description | |------|-------------| | get_balance | Account EntryPoint deposit | | get_policy_state | BudgetPolicy caps and spend | | set_budget_caps | Set BudgetPolicy caps (owner only) | | resolve_intent | Resolve intent to execution plan | | get_analytics | Account P&L, spend patterns | | get_credit_score | Credit score for account | | get_recommendations | Provider recommendations | | fleet_summary | Fleet overview | | fleet_accounts | Fleet account list | | fleet_alerts | Fleet on-chain alerts | | credit_state | CreditFacility state | | escrow_state | ConditionalEscrow state | | splitter_state | RevenueSplitter state | | sla_state | SLAContract state |

Usage

cd packages/mcp && pnpm run build && node dist/index.js

Example MCP config (replace <path-to-clone> with your checkout of economicagents/AEP):

{
  "mcpServers": {
    "aep": {
      "command": "node",
      "args": ["<path-to-clone>/packages/mcp/dist/index.js"]
    }
  }
}

Requires ~/.aep/config.json. set_budget_caps needs AEP_KEYSTORE_ACCOUNT (preferred) or PRIVATE_KEY.

Build & test

pnpm run build
pnpm run test

Documentation

• MCP reference
• Cookbook
• Integration guide