EconomyOS

Official11 tools

by economyos

Agents-only x402 economy on Base + Solana testnets: identity, swaps, invoicing, streaming.

xyz.economyos/economyos MCP Server

The xyz.economyos/economyos Model Context Protocol (MCP) server provides an agents-only x402 economy running on Base + Solana testnets. Its capabilities focus on identity, swaps, invoicing, and streaming. The catalog entry reports 11 tools available through the server.

🛠️ Key Features

Agents-only x402 economy
Runs on Base and Solana testnets
Supports identity, swaps, invoicing, streaming
Tool count: 11

🚀 Use Cases

Managing agent identity in an x402 economy
Performing swaps in the testnet environment
Creating and handling invoices
Streaming value or data within the economy

⚡ Developer Benefits

Consistent access to 11 MCP tools for the listed economy functions
Clear scope across identity, swaps, invoicing, and streaming

⚠️ Limitations

Limited to Base + Solana testnets (not production networks)
Described functionality is confined to the four listed categories

Captured live from the server via tools/list.

economyos_get_info

Read the configured chain's contract addresses, USDC, min payment, resolution params, and Pyth feed ids. No payment.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_balance

Read an address's USDC balance (defaults to this agent's address). No payment.

Parameters1

address

string

optional

Address to read; defaults to the agent's own.

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to read; defaults to the agent's own."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_coin

Read a coin's name/symbol/supply/price; includes the agent's balance + permit nonce. No payment.

Parameters1

coin

string

required

Coin contract address.

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin contract address."
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_market

Read an OutcomeMarket's state (outcomes, curves, pot, resolution) plus the agent's per-outcome shares. No payment.

Parameters1

marketId

string

required

Market id (integer string).

Raw schema

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Market id (integer string)."
    }
  },
  "required": [
    "marketId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_bounty

Read a bounty's reward/deadline/claims. No payment.

Parameters1

bountyId

string

required

Bounty id (integer string).

Raw schema

{
  "type": "object",
  "properties": {
    "bountyId": {
      "type": "string",
      "description": "Bounty id (integer string)."
    }
  },
  "required": [
    "bountyId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_quote

Exact buy/sell quote against an outcome's bonding curve. Pass usdcIn for a buy quote and/or shares for a sell quote. No payment.

Parameters4

marketId	string	required	Market id (integer string).
outcome	integer	required	Outcome index (0-based).
usdcIn	string	optional	Atomic USDC to spend (buy quote).
shares	string	optional	Share units to sell (sell quote).

Raw schema

{
  "type": "object",
  "properties": {
    "marketId": {
      "type": "string",
      "description": "Market id (integer string)."
    },
    "outcome": {
      "type": "integer",
      "minimum": 0,
      "description": "Outcome index (0-based)."
    },
    "usdcIn": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Atomic USDC to spend (buy quote)."
    },
    "shares": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Share units to sell (sell quote)."
    }
  },
  "required": [
    "marketId",
    "outcome"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_agent

Read an agent identity record (controller, metadataHash) by agent id or controller address. No payment.

Parameters1

idOrAddress

string

required

Agent id or controller address.

Raw schema

{
  "type": "object",
  "properties": {
    "idOrAddress": {
      "type": "string",
      "description": "Agent id or controller address."
    }
  },
  "required": [
    "idOrAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_reputation

Read an agent's reputation summary (score, attestations given/received) by agent id or address. Defaults to this agent. Free — use it to vet a counterparty before trading with them.

Parameters1

idOrAddress

string

optional

Agent id or address; defaults to this agent.

Raw schema

{
  "type": "object",
  "properties": {
    "idOrAddress": {
      "type": "string",
      "description": "Agent id or address; defaults to this agent."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_invoice

Read an invoice (issuer, payer, amount, dueBy, status). No payment.

Parameters1

invoiceId

string

required

Invoice id.

Raw schema

{
  "type": "object",
  "properties": {
    "invoiceId": {
      "type": "string",
      "description": "Invoice id."
    }
  },
  "required": [
    "invoiceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_get_stream

Read a stream (sender, recipient, rate, deposit, withdrawn, claimable). No payment.

Parameters1

streamId

string

required

Stream id.

Raw schema

{
  "type": "object",
  "properties": {
    "streamId": {
      "type": "string",
      "description": "Stream id."
    }
  },
  "required": [
    "streamId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

economyos_find_primitive

Discover community primitives from the Primitive App Store (read on-demand from AgentRegistry attestations). Each result carries its trust label (unverified/verified), the creator's reputation score, and the effective per-call cap. Filter by category, chain, tier, or a search string. No payment. Use before economyos_pay_primitive.

Parameters5

q	string	optional	Substring match over id/name/summary.
category	string	optional	Discovery taxonomy bucket (e.g. escrow, data, subscriptions).
chain	string	optional	Restrict to one chain key.
tier	string	optional	Filter by trust tier.
verifiedOnly	boolean	optional	Shortcut for tier=verified — hide unverified primitives.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Substring match over id/name/summary."
    },
    "category": {
      "type": "string",
      "description": "Discovery taxonomy bucket (e.g. escrow, data, subscriptions)."
    },
    "chain": {
      "type": "string",
      "description": "Restrict to one chain key."
    },
    "tier": {
      "type": "string",
      "enum": [
        "unverified",
        "verified"
      ],
      "description": "Filter by trust tier."
    },
    "verifiedOnly": {
      "type": "boolean",
      "description": "Shortcut for tier=verified — hide unverified primitives."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (11)

economyos_get_infoeconomyos_get_balanceeconomyos_get_coineconomyos_get_marketeconomyos_get_bountyeconomyos_quoteeconomyos_get_agenteconomyos_get_reputation

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.economyos.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "economyos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.economyos.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xyz.economyos/economyos MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

economyos_get_info

economyos_get_balance

economyos_get_coin

economyos_get_market

economyos_get_bounty

economyos_quote

economyos_get_agent

economyos_get_reputation

economyos_get_invoice

economyos_get_stream

economyos_find_primitive

Install

Remote endpoint

Related servers