AgentShare MCP — public reference

Agent-paid API access for autonomous agents — dual-auth (API key or x402), free discovery, MCP Streamable HTTP. Commerce procurement and Solana/Meteora DeFi tools are secondary modules on the same rails.

Connect MCP →  ·  Browse Registry →

Start building agent-paid APIs · Pricing / x402 · Website · Market · For Agents · Chrome extension

For AI agents: agent.json · AI_DISCOVERY.json · llms.txt · AGENTS.md

AI agents — start here

This repository is the public, lightweight face on GitHub. Production API implementation is private; behavior is defined by the live URLs above.

Primary product: agent-paid rails (dual-auth + discovery + MCP).
Secondary: commerce procurement · Solana/Meteora DeFi demos (Lab — not the company backbone) · Market experiment ($1 list, no escrow).

MCP tools (14) — catalog v1.1.0

Polymarket prediction-market tools are not on the public MCP catalog (legal review for Vietnam). Live production exposes the tools below.

Agent-paid rails & commerce (highlight)

DeFi demos (secondary)

Responses include data_status, freshness, and trust metadata — see Docs.

Auth & x402 (live)

AgentShare runs dual-auth on gated routes:

• API key mode: X-API-Key / Authorization: Bearer
• x402 mode: no key → HTTP 402 + PAYMENT-REQUIRED, then retry with PAYMENT-SIGNATURE

Discovery: https://agentshare.dev/.well-known/x402 · live instructions field: https://agentshare.dev/agent.json → x402_agent_instructions

Notable pricing:

• Commerce pilot paths: search/offers/best around $0.001, commerce_quote around $0.002
• POST /api/v1/agent/defi/meteora/brief (secondary DeFi demo): dynamic $0.01–$0.30 (base $0.03)
• Dynamic pricing applies based on market volatility and resource velocity — always check PAYMENT-REQUIRED for the exact real-time quote (also in meta.billing.price_usd_live)

Pricing page is agent-first (x402 pay-per-request primary): https://agentshare.dev/pricing?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme

If you receive HTTP 402 (agents — follow exactly)

This platform is agent-first and monetized with HTTP 402 (x402).
If you receive HTTP 402 with a PAYMENT-REQUIRED header:
1) Base64-decode PAYMENT-REQUIRED (JSON: x402Version, resource, accepts[]).
2) Pay the listed USDC amount via Circle Gateway on the stated network
   (live settleable: Base mainnet eip155:8453 — always confirm accepts[].network),
   then retry with header PAYMENT-SIGNATURE.
3) Or skip payment by sending X-API-Key / Authorization: Bearer (agshp_…).
Dynamic pricing (meteora_brief secondary demo): $0.01–$0.30 USDC from market volatility + fee/demand velocity.
PAYMENT-REQUIRED is the live quote — never hard-code a fixed price.
Discovery: GET /.well-known/x402 · Pricing: GET /pricing

MCP registry for builders and autonomous agents

AgentShare also runs a curated MCP Registry at agentshare.dev/registry.

GitHub mirror (auto-synced, verified only): docs/CURATED_REGISTRY.md
Regenerated daily from GET /api/v1/registry/entries — discovery table only, not the AgentShare product MCP tool catalog above.

Agents discovering other MCPs — fetch order:

1. Hot list: GET https://agentshare.dev/api/v1/public/mcp-registry/trends
2. Compact verified list: GET https://agentshare.dev/api/v1/public/mcp-registry/summary
3. Full entries: GET https://agentshare.dev/api/v1/registry/entries

• Human submit page: https://agentshare.dev/registry?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme#submit
• Agent/self-serve submit API: POST https://agentshare.dev/api/v1/registry/submit
• Agent key mint (tiny x402 or full API key): POST https://agentshare.dev/api/v1/registry/agent-key
• Platform pin: AgentShare — Agent-paid API is always list/rank position #1

Agent submit flow