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

Resource	URL
Authoritative contract	https://agentshare.dev/agent.json
Structured GitHub index	AI_DISCOVERY.json
LLM summary	llms.txt
Agent briefing	AGENTS.md
GEO draft: Custom Request Tool	docs/GEO_REQUEST_CAPABILITY.md
For-agents (JSON)	`GET https://agentshare.dev/for-agents` + `Accept: application/json`
Managed Agents template	https://agentshare.dev/api/v1/examples?template=managed-agent
MCP endpoint	https://agentshare.dev/mcp
MCP Registry (curated)	https://agentshare.dev/registry?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme
MCP Registry trends (JSON)	https://agentshare.dev/api/v1/public/mcp-registry/trends
MCP Registry summary (JSON)	https://agentshare.dev/api/v1/public/mcp-registry/summary
MCP server card (14 tools)	https://agentshare.dev/.well-known/mcp/server-card.json
Coverage (honest scope)	https://agentshare.dev/coverage?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme · DEFI_POSITIONING.md
Antigravity skill manifest	https://agentshare.dev/.well-known/antigravity-skills.json

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)

Tool	Purpose
`service_meta`	Capabilities, limits, coverage
`search_products`	Multi-source price comparison
`best_offer`	Single cheapest in-stock offer
`best_offer_under_budget`	Best offer under max price
`product_detail`	Full product by id from search
`commerce_quote`	ACP / agent-buyer listings envelope
`request_capability`	Custom Request Tool: structured capability gap → admin web inbox (auth + stake; no codegen)
`market_browse`	Browse Market classifieds (live HTTPS URLs, bids, likes) — experiment, not escrow
`market_list`	List a live web/app URL on Market ($1 x402 or API key). Store `manage_token` once.

DeFi demos (secondary)

Tool	Purpose
`dex_overview`	DEX protocol rankings by 24h volume (DefiLlama)
`dex_top_movers`	DEX protocols with largest 1d volume-change % (DefiLlama)
`solana_dex_brief`	Solana DEX ecosystem brief (Raydium, Orca, Meteora, …)
`meteora_brief`	Meteora DLMM pool brief (verdict, risk_score, top pools)
`meteora_pool_detail`	Meteora DLMM pool detail (bin depth, liquidity curve proxy, current price)

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)

Code

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:

Hot list: GET https://agentshare.dev/api/v1/public/mcp-registry/trends
Compact verified list: GET https://agentshare.dev/api/v1/public/mcp-registry/summary
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

Call POST https://agentshare.dev/api/v1/registry/agent-key
Authenticate either with:
- a normal X-API-Key, or
- x402: no key → receive HTTP 402 → pay tiny USDC amount → retry with PAYMENT-SIGNATURE
Receive a short-lived scoped key with scope registry:submit
Use that key on POST /api/v1/registry/submit
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).

Resource	URL
Chrome Web Store	https://chromewebstore.google.com/detail/agentshare-agent-readiness/nimndnhajfkicbnipbfdkmgencjejjed?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme
Docs	docs/CHROME_EXTENSION.md
ARS spec	https://agentshare.dev/docs?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme#agent-readiness-score
Prompt Injection Fix Guide	https://agentshare.dev/docs?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme#prompt-injection-fix-guide

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/

Path	Purpose
`agentshare-commerce-mcp/.cursor-plugin/plugin.json`	Cursor plugin manifest
`agentshare-commerce-mcp/mcp.json`	MCP server wiring (Node bridge + `AGENTSHARE_API_KEY`)
`agentshare-commerce-mcp/.mcp.json`	Open Plugins / cursor.directory auto-detect (Streamable HTTP URL)
`.mcp.json`	Same at repo root for directory scanners
`agentshare-commerce-mcp/server/bridge.mjs`	Stdio ↔ Streamable HTTP bridge
`.cursor-plugin/marketplace.json`	Multi-plugin index (repo root)

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

Guide	Action
docs/CURSOR_DIRECTORY.md	Submit cursor.directory/mcp/new + plugins/new
docs/AWESOME_MCP_PR.md	PR line for awesome-mcp-servers (agent-paid / commerce framing)
docs/DISCORD_SHOWCASE.md	Copy-paste MCP Discord showcase post

Generate Cursor one-click install link:

bash

node scripts/cursor-deeplink.mjs

Local verify:

bash

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)

config.json

{
  "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