EconomyOS

Official11 tools

by economyos

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

MCP Server: xyz.economyos/economyos

This MCP server (“xyz.economyos/economyos”) provides an agents-only x402 economy on Base and Solana testnets. The described capabilities include identity, swaps, invoicing, and streaming. Server metadata is referenced as an economy integration focused on these agent-driven functions across the specified networks.

🛠️ Key Features

Agents-only x402 economy
Runs on Base testnet and Solana testnet
Supports: identity
Supports: swaps
Supports: invoicing
Supports: streaming

🚀 Use Cases

Agent identity workflows on Base and Solana testnets
Token or asset swap flows in a testnet economy
Generating and managing invoices in an agent-driven system
Streaming-related flows in the same economy context

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.

EconomyOS - agentage MCP Catalog