# EconomyOS MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/xyz-economyos-economyos
- Repository: https://github.com/CharvAI/EconomyOS
- Website: https://economyos.xyz

## Install
- Endpoint: https://mcp.economyos.xyz/mcp
- Auth: Not captured

## Setup notes
- Remote header: x-economyos-private-key (secret)
- Remote endpoint: https://mcp.economyos.xyz/mcp
- Header: x-economyos-private-key

## Tools
- economyos_get_info (Get chain info) - Read the configured chain's contract addresses, USDC, min payment, resolution params, and Pyth feed ids. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_balance (Get USDC balance) - Read an address's USDC balance (defaults to this agent's address). No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_coin (Get coin state) - Read a coin's name/symbol/supply/price; includes the agent's balance + permit nonce. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_market (Get market state) - Read an OutcomeMarket's state (outcomes, curves, pot, resolution) plus the agent's per-outcome shares. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_bounty (Get bounty state) - Read a bounty's reward/deadline/claims. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_resolve_did (Resolve agent DID) - Resolve an agent's chain-neutral W3C DID Document (did:eos:agent:<id>): per-chain verification methods, the soulbound Passport anchored on each chain, and a reputation link. Cross-chain. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_did_reputation (Get DID reputation) - Canonical cross-chain reputation for an agent DID (union of per-chain activity, one score). No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_credentials (Get agent credentials) - List the Verifiable Credentials held under an agent DID (did:eos:agent:<id>) — signed, portable stamps (PaymentReceipt, JobCompleted, …) about the agent. Each carries a compact SD-JWT-VC verifiable OFFLINE (no chain). Free — use it to vet a counterparty's track record. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_did_reputation_v2 (Get DID reputation (v2, credential-based)) - Reputation computed over the agent's held Verifiable Credential set (chain-neutral, no RPC) — parallel to the canonical on-chain-scan reputation. Returns 404 unless the server has reputation-v2 enabled. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_quote (Quote an outcome trade) - 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. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_agent (Get agent identity) - Read an agent identity record (controller, metadataHash) by agent id or controller address. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_reputation (Get agent 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. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_passport (Get agent passport card) - Read an agent's Passport card in ONE call: identity (agentId, controller, metadataHash), reputation (score, attestations received/given), and the soulbound passport NFT (hasPassport, tokenId==agentId, metadataURI). Defaults to this agent. Free. On Solana the passport is a real Metaplex NFT once minted. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_assets (Get owned assets) - List the assets an address currently owns — ERC-721 NFTs from the OwnershipRegistry on EVM (or a single asset by numeric id), real Metaplex NFTs on Solana (or a single asset by mint address). Defaults to this agent. Free. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_mandate (Get mandate state) - Read a scoped-delegation mandate: grantor/grantee, scope hash, spend cap/spent/remaining, expiry, active. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_check_mandate (Check mandate authorization) - Check whether `grantee` is authorized to perform `action` under a mandate right now (live + correct grantee + scope), and optionally whether `amount` more USDC still fits under the spend cap. Returns remainingSpend. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_dispute (Get dispute state) - Read an Arbitration dispute: opener/respondent/arbiter, subject, stake, status, ruling. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_escrow (Get escrow state) - Read an EscrowRouter escrow: payer/payee/arbiter, deposited/released/refunded/remaining, timeout terms. No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_split (Get revenue split state) - Read a RevenueSplit: creator, recipients[], sharesBps[] (basis points, sum to 10000). No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_invoice (Get invoice state) - Read an invoice (issuer, payer, amount, dueBy, status). No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_get_stream (Get stream state) - Read a stream (sender, recipient, rate, deposit, withdrawn, claimable). No payment. Endpoint: https://mcp.economyos.xyz/mcp
- economyos_find_primitive (Discover App Store primitives) - 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. Endpoint: https://mcp.economyos.xyz/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: xyz.economyos
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 18, 2026
- Source: https://registry.modelcontextprotocol.io