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
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).
Polymarket prediction-market tools are not on the public MCP catalog (legal review for Vietnam). Live production exposes the tools below.
| 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. |
| 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.
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 withPAYMENT-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/bestaround$0.001,commerce_quotearound$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-REQUIREDfor the exact real-time quote (also inmeta.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
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
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 - No free platform pin — AgentShare’s own MCP ranks like any other verified listing
- Optional paid Featured (scarce Hub slots, humans + agents):
GET /api/v1/registry/feature/packsthenPOST /api/v1/registry/feature/{week|month|year}with{"token":"<submission_token>"}(API key or x402). Experiment: week $3 · month $9 · year $49
- 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
- a normal
- Receive a short-lived scoped key with scope
registry:submit - Use that key on
POST /api/v1/registry/submit - Listing stays
pending_reviewuntil 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
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.
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:
node scripts/cursor-deeplink.mjsLocal verify:
cd agentshare-commerce-mcp
npm install --omit=dev
npm run verify
# optional live probe:
# set AGENTSHARE_API_KEY=agshp_... (Windows)
npm run verifyCursor Marketplace org applications are reviewed selectively (2026); use cursor.directory for community listing — see docs/CURSOR_DIRECTORY.md.
{
"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.
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 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).
Agent-paid rails · commerce procurement · secondary Solana/Meteora DeFi demos — https://agentshare.dev/coverage?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme
MIT — LICENSE