{"schema_version":"1.0","name":"AgentShare","type":"agent_paid_api","primary_focus":"agent_paid_rails","secondary_focus":["commerce_price_api","defi_intelligence_demo"],"description":"Agent-paid API for autonomous agents: dual-auth (API key or x402 USDC), free discovery (agent.json, /.well-known/x402), MCP Streamable HTTP. Secondary modules: commerce procurement and Solana/Meteora DeFi demos on the same rails.","base_url":"https://agentshare.dev","human_documentation_url":"https://agentshare.dev/docs","maintainer":{"handle":"anhmtk","name":"anhmtk","role":"founder_maintainer","based_in":"Vietnam","url":"https://github.com/anhmtk","same_as":["https://github.com/anhmtk","https://github.com/anhmtk/agentshare-mcp","https://dev.to/anhmtk","https://x.com/AnhNguyen136515"],"about":"https://agentshare.dev/about#maintainer","note":"Product brand is AgentShare; anhmtk is the independent founder/maintainer handle (GitHub / Dev.to). Not a separate consumer product."},"discovery_urls":{"this_file":"https://agentshare.dev/agent.json","well_known":"https://agentshare.dev/.well-known/agentshare.json","well_known_discovery_index":"https://agentshare.dev/.well-known/discovery.json","mcp_json":"https://agentshare.dev/mcp.json","meta":"https://agentshare.dev/api/v1/meta","agent_capabilities":"https://agentshare.dev/api/v1/agent-capabilities","examples":"https://agentshare.dev/api/v1/examples","changelog":"https://agentshare.dev/changelog.json","for_agents":"https://agentshare.dev/for-agents","health":"https://agentshare.dev/api/v1/health","openapi":"https://agentshare.dev/openapi.json","protocol":"https://agentshare.dev/api/v1/protocol","llm_txt":"https://agentshare.dev/llm.txt","llms_full_txt":"https://agentshare.dev/llms-full.txt","mcp_stdio_repo_llms_txt":"https://raw.githubusercontent.com/anhmtk/agentshare-mcp/main/llms.txt","legal_index":"https://agentshare.dev/legal/index.json","coverage":"https://agentshare.dev/coverage","commerce_quote":"https://agentshare.dev/api/v1/agent/commerce/quote","defi_meteora_brief":"https://agentshare.dev/api/v1/agent/defi/meteora/brief","defi_meteora_pool_detail":"https://agentshare.dev/api/v1/agent/defi/meteora/pool-detail","defi_solana_brief":"https://agentshare.dev/api/v1/agent/defi/solana/brief","dex_overview":"https://agentshare.dev/api/v1/dex/overview","dex_top_movers":"https://agentshare.dev/api/v1/dex/top-movers","public_data_quality":"https://agentshare.dev/api/v1/public/data-quality","mcp_server_card":"https://agentshare.dev/.well-known/mcp/server-card.json","mcp_tools_catalog":"https://agentshare.dev/api/v1/mcp/tools","signup":"https://agentshare.dev/signup","antigravity_skills_manifest":"https://agentshare.dev/.well-known/antigravity-skills.json","antigravity_skill_md":"https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/SKILL.md","antigravity_mcp_config":"https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/resources/mcp-config.json","managed_agent_examples":"https://agentshare.dev/api/v1/examples?template=managed-agent","for_agents_discovery_json":"https://agentshare.dev/for-agents (GET with Accept: application/json, no text/html)"},"for_agents_page":{"html_url":"https://agentshare.dev/for-agents","json_discovery":"GET /for-agents with header Accept: application/json (omit text/html) returns kind agentshare_for_agents_discovery","json_ld":"Embedded in HTML when served as text/html","link_rel_agent_discovery":"Link header points to /agent.json"},"antigravity":{"skill_name":"agentshare-price-intelligence","skill_install_paths":{"global":"~/.gemini/antigravity/skills/agentshare-price-intelligence/SKILL.md","workspace":".agents/skills/agentshare-price-intelligence/SKILL.md"},"manifest_url":"https://agentshare.dev/.well-known/antigravity-skills.json","skill_url":"https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/SKILL.md","mcp_streamable_http_url":"https://agentshare.dev/mcp","managed_agents_hint":"Register MCP url and X-API-Key in Gemini Managed Agents / Antigravity tool list; see skill SKILL.md for commerce_quote and product_detail workflows."},"welcome":{"message":"AgentShare is an agent-paid API: dual-auth (API key or x402), free discovery, MCP. Start at /agent.json and /api/v1/examples. Commerce and Solana/Meteora DeFi are secondary modules.","first_steps":["GET https://agentshare.dev/agent.json","GET https://agentshare.dev/.well-known/x402 — dual-auth + live prices (no key)","Start building: POST https://agentshare.dev/api/v1/auth/register or GET https://agentshare.dev/signup — or settle x402 with no key","GET https://agentshare.dev/api/v1/examples — copy-paste dual-auth snippets","Secondary commerce: GET https://agentshare.dev/api/v1/search (X-API-Key OR x402)","Secondary DeFi demo: POST https://agentshare.dev/api/v1/agent/defi/meteora/brief (X-API-Key OR x402)","If HTTP 402: decode PAYMENT-REQUIRED, settle via Circle Gateway, retry with PAYMENT-SIGNATURE","To list an MCP as an agent: POST https://agentshare.dev/api/v1/registry/agent-key (tiny x402 or full key) → receive scoped registry:submit key → POST https://agentshare.dev/api/v1/registry/submit","Optional MCP: https://agentshare.dev/mcp (same credentials)"]},"error_contract":{"envelope_ok":{"status":"ok","data":"object","meta":"object?"},"envelope_error":{"status":"error","error":{"code":"string","message":"string","retry_after?":"int"}},"ax_fields_on_error":["docs_for_agent_url","protocol_url","for_agents_url","examples_url","changelog_url","openapi_url","signup_url","suggestion","retry_after_seconds"],"protocol_spec":"https://agentshare.dev/api/v1/protocol"},"authentication":{"type":"dual_auth","modes":["api_key","x402"],"api_key_header":"X-API-Key","api_key_alternate":"Authorization: Bearer","x402_on_402":"PAYMENT-REQUIRED","x402_retry_header":"PAYMENT-SIGNATURE","x402_discovery":"https://agentshare.dev/.well-known/x402","pricing_url":"https://agentshare.dev/pricing","note":"Dual-auth on gated data routes (commerce + DeFi including meteora_brief, MCP /mcp when protect-all): send X-API-Key (agshp_…) OR settle x402 after HTTP 402. meteora_brief is dynamic-priced ($0.01–$0.30): read live USDC from PAYMENT-REQUIRED / meta.billing.price_usd_live. Free (no key, no payment): /agent.json, /.well-known/*, /docs, /pricing, /api/v1/protocol, /api/v1/meta, /api/v1/health, /mcp.json, signup/auth. See x402_agent_instructions and GET /.well-known/x402.","x402_agent_instructions":"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 with x402Version, resource, accepts[]). (2) Pay the listed USDC amount via Circle Gateway on the stated network (production: Base mainnet eip155:8453), then retry the same request with header PAYMENT-SIGNATURE. (3) Or skip payment by sending X-API-Key / Authorization: Bearer (agshp_…). Dynamic pricing (meteora_brief): quotes move with market volatility and fee/demand velocity ($0.01–$0.30 USDC band). The PAYMENT-REQUIRED header is the only source of truth for the live amount — never assume a fixed price. Discovery: GET /.well-known/x402. Pricing: GET /pricing. Marketing/docs/discovery/onboarding paths stay free (no 402)."},"x402_agent_instructions":"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 with x402Version, resource, accepts[]). (2) Pay the listed USDC amount via Circle Gateway on the stated network (production: Base mainnet eip155:8453), then retry the same request with header PAYMENT-SIGNATURE. (3) Or skip payment by sending X-API-Key / Authorization: Bearer (agshp_…). Dynamic pricing (meteora_brief): quotes move with market volatility and fee/demand velocity ($0.01–$0.30 USDC band). The PAYMENT-REQUIRED header is the only source of truth for the live amount — never assume a fixed price. Discovery: GET /.well-known/x402. Pricing: GET /pricing. Marketing/docs/discovery/onboarding paths stay free (no 402).","x402_dynamic_pricing_notice":"Dynamic pricing applies based on market volatility and resource velocity ($0.01–$0.30 USDC for meteora_brief). Check PAYMENT-REQUIRED for the exact real-time quote; also stamped in meta.billing.price_usd_live / meta.billing.dynamic_pricing_notice.","signup":{"register":"POST /api/v1/auth/register","register_url":"https://agentshare.dev/api/v1/auth/register","body_json":{"email":"string","password":"string (min 8 chars)"},"returns":"api_key once (same format as agshp_...)"},"api_version":"1.0.0","coverage":{"spec_url":"https://agentshare.dev/coverage","focus_summary":"Primary: agent-paid API access — dual-auth (API key or x402), free discovery, MCP. Secondary commerce catalog (GET /coverage): AI local hardware, robotics, drone/RC power. Secondary DeFi demos: Meteora DLMM + Solana (see /api/v1/agent/defi/*) on the same rails — DeFi is not the company backbone."},"mcp":{"streamable_http_url":"https://agentshare.dev/mcp","same_key_as_rest":true,"tools":["dex_overview","dex_top_movers","solana_dex_brief","meteora_brief","meteora_pool_detail","search_products","best_offer","best_offer_under_budget","product_detail","commerce_quote","service_meta"],"read_only_catalog_urls":["https://agentshare.dev/.well-known/mcp/server-card.json","https://agentshare.dev/api/v1/mcp/tools"],"discovery_note":"Read-only tool catalog (no API key): GET /.well-known/mcp/server-card.json and GET /api/v1/mcp/tools. Live Streamable HTTP at /mcp requires X-API-Key (or Bearer) and keeps an SSE session — use the static catalog first (e.g. Gemini Side Panel, Smithery scans) before connecting. meteora_brief uses dynamic x402 pricing ($0.01–$0.30): read the live quote from PAYMENT-REQUIRED or meta.billing.price_usd_live — never hard-code a fixed price."},"mcp_listings":{"positioning":"Curated, editor-reviewed MCP registry for agent tools—built to complement AgentShare REST + MCP, not as a generic open directory.","landing":"https://agentshare.dev/registry","entries_json":"https://agentshare.dev/api/v1/registry/entries","summary_json":"https://agentshare.dev/api/v1/public/mcp-registry/summary","trends_json":"https://agentshare.dev/api/v1/public/mcp-registry/trends","detail_url_pattern":"https://agentshare.dev/registry/{id}","agent_submit_key_url":"https://agentshare.dev/api/v1/registry/agent-key","agent_submit_flow":"Agents may pay a tiny x402 amount (or use a full API key) to mint a scoped registry:submit key, then POST /api/v1/registry/submit. Every listing stays pending_review until AgentShare approves it.","suggest_tags_url":"https://agentshare.dev/api/v1/registry/suggest-tags","listing_template":{"name":{"pattern":"[Product] MCP — [primary capability]","example":"CRM Sync MCP — Salesforce contact lookup","max_length":200,"tip":"Lead with what the MCP does; avoid vague names like 'My Server'."},"description":{"pattern":"[What it does in one sentence]. [Who it is for]. [How to connect — e.g. Streamable HTTP MCP, auth method]. [One differentiator or data source].","example":"Exposes read-only Salesforce contacts and accounts to agents via MCP tools. Built for sales ops and support bots. Connect with Streamable HTTP at /mcp using your org API token. Includes pagination and field filters.","min_length":8,"max_length":4000,"tip":"Use concrete nouns from your domain so search and agent discovery match your product."},"category":{"allowed":["data_commerce","agent_tools","integrations","storage","analytics"],"tip":"Pick the closest fit; tags carry finer-grained domain keywords."},"tags":{"format":"comma-separated, lowercase, no # prefix","example":"crm, salesforce, contacts, api","max_length":500,"tip":"Call POST /api/v1/registry/suggest-tags with your draft fields for tailored suggestions."},"github_url":{"required":true,"pattern":"https://github.com/owner/repo","tip":"Public repo or org path; reviewers use this to verify the project."},"website_url":{"required":true,"pattern":"https://your-product.com","tip":"Landing page or docs home — not only the raw MCP endpoint."},"mcp_url":{"required":true,"pattern":"https://host/mcp","tip":"HTTPS MCP endpoint agents will call after approval."}},"geo_optimization_hint":"Write for both humans and agents: clear capability, audience, transport, and domain-specific keywords that match your product (not generic blockchain tags unless your MCP is actually about that domain).","platform_pin":"AgentShare — Agent-paid API is always rank/list position 1 on /registry, entries JSON, summary, and trends."},"tools":[{"name":"dex_overview","description":"DEX protocol rankings by 24h volume (DefiLlama)","method":"GET","path":"/api/v1/dex/overview","query_params":["chain","limit","sort_by"],"requires_auth":false},{"name":"dex_top_movers","description":"DEX protocols with largest 24h volume change %","method":"GET","path":"/api/v1/dex/top-movers","query_params":["chain","limit","min_volume_24h_usd"],"requires_auth":false},{"name":"solana_dex_brief","description":"Solana DEX ecosystem brief (Raydium, Orca, Meteora, …)","method":"GET","path":"/api/v1/agent/defi/solana/brief","query_params":["limit","highlights_only"],"requires_auth":false},{"name":"meteora_brief","description":"Meteora DLMM pool brief (verdict, risk, momentum, top pools). Dynamic x402 pricing ($0.01–$0.30): exact USDC quote is in PAYMENT-REQUIRED on HTTP 402 and in meta.billing.price_usd_live.","method":"POST","path":"/api/v1/agent/defi/meteora/brief","body_json":{"kind":"top_pools","window":"24h","sort_by":"fee_tvl_ratio","limit":10},"requires_auth":true,"price_scheme":"dynamic","price_usd_band":{"min":0.01,"base":0.03,"max":0.3}},{"name":"meteora_pool_detail","description":"Meteora DLMM single-pool detail (bin depth, liquidity curve)","method":"POST","path":"/api/v1/agent/defi/meteora/pool-detail","body_json":{"pool_address":"string (required)","wallet_address":"string (optional)"},"requires_auth":true},{"name":"search_products","description":"Search products across sources with prices and freshness metadata","method":"GET","path":"/api/v1/search","query_params":["q","limit"],"requires_auth":true},{"name":"best_offer","description":"Lowest in-stock offer for a query","method":"GET","path":"/api/v1/offers/best","query_params":["q"],"requires_auth":true},{"name":"best_offer_under_budget","description":"Best offer under max price (same unit as currency: VND or USD)","method":"GET","path":"/api/v1/offers/best-under-budget","query_params":["q","query","max_price","currency"],"requires_auth":true},{"name":"commerce_quote","description":"Stable ACP/Virtuals quote: agentshare.price.v1 listings via search or best_offer","method":"POST","path":"/api/v1/agent/commerce/quote","body_json":{"query":"string (required)","mode":"search | best_offer","limit":"integer 1-50 (search only)","max_price_usd":"number optional (budget in same unit as currency)","currency":"USD | VND"},"requires_auth":true},{"name":"commerce_quote_get","description":"GET convenience alias for commerce_quote","method":"GET","path":"/api/v1/agent/commerce/quote","query_params":["q","query","mode","limit","max_price_usd","currency"],"requires_auth":true},{"name":"product_detail","description":"Product by id with prices by source","method":"GET","path":"/api/v1/products/{id}","requires_auth":true},{"name":"submit_product_url","description":"Alpha: suggest a marketplace product page URL for catalog coverage (community). JSON body: url (required), notes (optional). Rate-limited; optional X-API-Key raises hourly cap.","method":"POST","path":"/api/v1/products/submit","body_json":{"url":"string (https product page)","notes":"string (optional)"},"requires_auth":false},{"name":"service_meta","description":"Capabilities and endpoint list (no auth)","method":"GET","path":"/api/v1/meta","requires_auth":false}],"data_sources":["aliexpress","accesstrade"]}