agentshare-mcp

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.

 · 

·

·

·

·

For AI agents:

·

·

·

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).

MCP tools (12) — 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

1. Call `POST https://agentshare.dev/api/v1/registry/agent-key`

2. Authenticate either with:

3. Receive a short-lived scoped key with scope `registry:submit`

4. Use that key on `POST /api/v1/registry/submit`

5. Listing stays `pending_review` until AgentShare approves it

Approved listings get:

• a public detail page (`/registry/{id}`)
• owner analytics (opens, referrers, countries, client types)
• quick-share actions for X, LinkedIn, Facebook, GitHub README snippets, and copy-link

Chrome extension (Agent Readiness + Prompt Injection Scan + MCP Connect)

Free browser extension — ARS site scan + Prompt Injection Scan (client-side DOM) + MCP Connect (copy Cursor/Claude/VS Code config for `agentshare.dev/mcp`).

Extension source is proprietary (private backend repo); this public repo documents the product for discovery.

Cursor Marketplace plugin

Official Cursor plugin scaffold: **agentshare-commerce-mcp/**

Discovery & listing (do these while Marketplace is closed):

Generate Cursor one-click install link:

node scripts/cursor-deeplink.mjs

Local verify:

cd agentshare-commerce-mcp
npm install --omit=dev
npm run verify
# optional live probe:
# set AGENTSHARE_API_KEY=agshp_...   (Windows)
npm run verify

Cursor Marketplace org applications are reviewed selectively (2026); use cursor.directory for community listing — see docs/CURSOR_DIRECTORY.md.

Quick connect (MCP)

{
  "mcpServers": {
    "agentshare": {
      "url": "https://agentshare.dev/mcp",
      "headers": { "X-API-Key": "YOUR_AGENTSHARE_KEY" }
    }
  }
}

Start building agent-paid APIs: https://agentshare.dev/signup?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme

(free-tier dual-auth credentials, or settle x402 with no key)

Prefer autonomous-agent payment via x402: https://agentshare.dev/.well-known/x402

See mcp-config.json and server/bridge.mjs for Node bridge.

Disclaimers

Informational only — not financial advice. Agents/users own their decisions (including any on-chain actions). Vietnam: service not intended for users located there; access (incl. VPN) = you assume local legal responsibility. Full terms: https://agentshare.dev/terms

Antigravity & Gemini (2026)

• Antigravity skill: `agentshare-price-intelligence` — https://agentshare.dev/.well-known/antigravity-skills.json
• Gemini Managed Agents: https://agentshare.dev/api/v1/examples?template=managed-agent

Aligned with Google I/O 2026 agentic stack (Antigravity 2.0, SDK, Gemini 3.5 Flash tool loops).

Coverage

Agent-paid rails · commerce procurement · secondary Solana/Meteora DeFi demos —

https://agentshare.dev/coverage?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme

License

MIT — LICENSE