Agent Price API
Một máy chủ MCP hiệu suất cao cung cấp dữ liệu giá thời gian thực có cấu trúc cho phần cứng AI trên các thị trường toàn cầu, được xây dựng với trọng tâm là khám phá gốc tác nhân thay vì các điểm cuối được mã hóa cứng.
Tài liệu
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 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
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:
- 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
- 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
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/
| 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.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