MCP Tools

Add the AEP MCP server to Cursor or any MCP-compatible client. Tools cover balance, policy, intent resolution, analytics, fleet, and economic relationships.

Registry version: @economicagents/mcp 0.2.0 on npm (August 2026). Repo main is 0.3.0.

Add to ~/.cursor/mcp.json (or your client's MCP config):

{
  "mcpServers": {
    "aep": {
      "command": "npx",
      "args": ["-y", "@economicagents/mcp@0.2.0"]
    }
  }
}

The published bin is aep-mcp. Smoke-test locally:

npx @economicagents/mcp@0.2.0
# MCP servers wait on stdio — configure via Cursor rather than running interactively

Global install (alternative)

npm install -g @economicagents/mcp@0.2.0
{
  "mcpServers": {
    "aep": {
      "command": "aep-mcp"
    }
  }
}

From monorepo (contributors)

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

Requires pnpm run build in packages/mcp first.

Prerequisites

Most tools read ~/.aep/config.json (account, RPC, factories). Deploy an account first — see Quick start.

Intent resolution (resolve_intent) needs a synced provider index (aep-index sync) or a reachable REST API you operate — the hosted reference at https://api.economicagents.org is currently offline (HTTP 521); self-host from packages/api or use CLI aep resolve against your instance.

For AI agents

When to use each tool:

ToolWhen to use
get_balanceCheck account EntryPoint deposit
get_policy_stateView budget caps and current spend
set_budget_capsSet BudgetPolicy caps (owner only)
resolve_intentResolve intent to execution plan
get_analyticsAccount P&L, spend patterns
get_credit_scoreCredit score for account
get_recommendationsProvider recommendations
fleet_summaryFleet overview
fleet_accountsFleet account list
fleet_alertsFleet on-chain alerts
credit_stateCreditFacility state
escrow_stateConditionalEscrow state
splitter_stateRevenueSplitter state
sla_stateSLAContract state

Tools reference

ToolDescription
get_balanceAccount EntryPoint deposit
get_policy_stateBudgetPolicy caps and spend
set_budget_capsSet BudgetPolicy caps (owner only)
resolve_intentResolve intent to execution plan
get_analyticsAccount P&L, spend patterns
get_credit_scoreCredit score for account
get_recommendationsProvider recommendations
fleet_summaryFleet overview
fleet_accountsFleet account list
fleet_alertsFleet on-chain alerts
credit_stateCreditFacility state
escrow_stateConditionalEscrow state
splitter_stateRevenueSplitter state
sla_stateSLAContract state

See also Installing skills for OpenClaw skill packs (optional context, not a substitute for MCP).