AgentShare MCP — public reference
Curated MCP registry — discover and list remote MCP servers (editor-reviewed, not a dump).
AgentShare also runs its own agent-paid MCP (12 tools): dual-auth (API key or x402).
Commerce and Solana/Meteora DeFi are Lab/secondary on those rails.
Connect MCP →
·
Browse Registry →
Signup (API key)
·
Pricing / x402
·
Website
·
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](./AI_DISCOVERY.json) |
| **LLM summary** | [llms.txt](./llms.txt) |
| **Agent briefing** | [AGENTS.md](./AGENTS.md) |
| **GEO draft: Custom Request Tool** | [docs/GEO_REQUEST_CAPABILITY.md](./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 (12 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](./docs/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.
**Public face:** curated MCP registry at [agentshare.dev/registry](https://agentshare.dev/registry).
**Own paid tools (not the homepage):** dual-auth rails + commerce · Solana/Meteora DeFi demos (Lab — not the company backbone).
The Market classifieds experiment (`/market`, `market_browse` / `market_list`) was **removed 2026-10-03**.
---
## 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)
| 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) |
### 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](https://agentshare.dev/docs?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme).
---
## 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 2, resource, one accepts[] row).
2) Sign that exact row. On Base mainnet (eip155:8453) the EIP-712 domain name is
"USD Coin" version "2" for native USDC. Do not filter extra.name on the string USDC
and do not look for GatewayWalletBatched.
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](https://agentshare.dev/registry?utm_source=github&utm_medium=agentshare-mcp&utm_campaign=readme).
**GitHub mirror (auto-synced, verified only):** [docs/CURATED_REGISTRY.md](./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`
- **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/packs` then `POST /api/v1/registry/feature/{week|month|year}` with `{"token":""}` (API key or x402). Experiment: week $3 · month $9 · year $49
### Agent submit flow
1. Call `POST https://agentshare.dev/api/v1/registry/agent-key`
2. Authenticate either with:
- a normal `X-API-Key`, or
- **x402**: no key → receive HTTP 402 → pay tiny USDC amount → retry with `PAYMENT-SIGNATURE`
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`).
| 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](./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/](./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](./docs/CURSOR_DIRECTORY.md) | Submit [cursor.directory/mcp/new](https://cursor.directory/mcp/new) + [plugins/new](https://cursor.directory/plugins/new) |
| [docs/AWESOME_MCP_PR.md](./docs/AWESOME_MCP_PR.md) | PR line for [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) (agent-paid / commerce framing) |
| [docs/DISCORD_SHOWCASE.md](./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](./docs/CURSOR_DIRECTORY.md).
---
## Quick connect (MCP)
```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](./mcp-config.json) and [server/bridge.mjs](./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](./LICENSE)