# AgentShare — AI discovery index (llms.txt)
# Canonical live API: https://agentshare.dev
# GitHub: https://github.com/anhmtk/agentshare-mcp
# Structured JSON mirror: https://raw.githubusercontent.com/anhmtk/agentshare-mcp/main/AI_DISCOVERY.json
# MCP catalog version: 1.1.0 (12 tools)
# Public face: curated MCP registry; own paid MCP is secondary

## ENTITY
- name: AgentShare
- url: https://agentshare.dev
- type: curated_mcp_registry_and_agent_paid_mcp
- github_public_face: https://github.com/anhmtk/agentshare-mcp

## ONE_LINE_SUMMARY
Curated MCP registry (editor-reviewed remote MCP listings) plus AgentShare's own agent-paid MCP: dual-auth (API key or x402 USDC), free discovery, Streamable HTTP. Secondary modules: commerce procurement and Solana/Meteora DeFi demos. Not a consumer storefront; DeFi is not the company backbone. Market classifieds experiment ended 2026-10-03.

## PRIMARY_DISCOVERY_FETCH_ORDER
1. https://agentshare.dev/agent.json
2. https://agentshare.dev/.well-known/x402 — x402 seller discovery (endpoints, dual-auth, live prices)
3. https://agentshare.dev/.well-known/discovery.json
4. https://agentshare.dev/for-agents — use Accept: application/json (no text/html) for compact JSON kind agentshare_for_agents_discovery
5. https://agentshare.dev/api/v1/examples?template=managed-agent — Gemini Managed Agents / Antigravity MCP JSON template
6. https://agentshare.dev/.well-known/mcp/server-card.json — static MCP tool schemas (12 tools on public catalog)
7. https://agentshare.dev/api/v1/public/mcp-registry/trends — curated MCP registry hot list (engagement rank; no free platform pin)
8. https://agentshare.dev/api/v1/public/mcp-registry/summary — compact verified MCP listings
9. https://agentshare.dev/openapi.json
10. https://agentshare.dev/pricing — agent-first: x402 pay-per-request primary; monthly API-key plans secondary

## MCP_ENDPOINT
- transport: streamable_http
- url: https://agentshare.dev/mcp
- auth: dual — X-API-Key / Authorization: Bearer OR (REST) x402 PAYMENT-SIGNATURE after HTTP 402
- signup: https://agentshare.dev/signup — Start building agent-paid APIs
- x402_discovery: https://agentshare.dev/.well-known/x402
- catalog_version: 1.1.0

## MCP_TOOLS (twelve — public catalog)
| tool_name | use_when | rest_upstream | layer |
| search_products | compare multiple listings | GET /api/v1/search | commerce |
| best_offer | one cheapest in-stock offer | GET /api/v1/offers/best | commerce |
| best_offer_under_budget | budget cap / under $X | GET /api/v1/offers/best-under-budget | commerce |
| product_detail | have product_id from search | GET /api/v1/products/{id} | commerce |
| commerce_quote | ACP / autonomous buyer envelope agentshare.price.v1 | POST /api/v1/agent/commerce/quote | commerce |
| request_capability | fixed tools insufficient — structured capability gap for human review (no codegen) | POST /api/v1/agent/capabilities/request | rails |
| service_meta | capabilities, limits, sources | GET /api/v1/meta | rails |
| dex_overview | rank DEX protocols by volume | GET /api/v1/dex/overview | defi_demo |
| dex_top_movers | DEX volume change movers | GET /api/v1/dex/top-movers | defi_demo |
| solana_dex_brief | Solana DEX ecosystem brief | GET /api/v1/agent/defi/solana/brief | defi_demo |
| meteora_brief | Meteora DLMM pool brief (verdict, risk) — secondary; x402 dynamic $0.01–$0.30 | POST /api/v1/agent/defi/meteora/brief | defi_demo |
| meteora_pool_detail | Meteora DLMM pool detail (bin depth, curve proxy, price) | POST /api/v1/agent/defi/meteora/pool-detail | defi_demo |

## NOT_ON_PUBLIC_MCP
Polymarket tools (polymarket_markets, polymarket_market_detail, polymarket_top_movers, polymarket_brief) are disabled on the public MCP catalog and anonymous discovery — legal review for Vietnam.

## DISCLAIMERS (IMPORTANT)
- Informational only — not financial advice. Agents/users own their decisions (incl. on-chain).
- Vietnam notice: service not intended for users located in Vietnam (incl. VPN → you assume local legal responsibility).
- Full terms: https://agentshare.dev/terms

## MIEN_TRU_TRACH_NHIEM (VN)
- Chỉ phân tích tham khảo — không phải lời khuyên đầu tư. Agent/user tự chịu trách nhiệm. Không nhắm tới user tại Việt Nam.

## AUTHENTICATION (dual-auth — prefer x402 for autonomous agents)
- mode_a_api_key: X-API-Key: agshp_... OR Authorization: Bearer agshp_...
- mode_b_x402: no key → gated REST returns HTTP 402 + PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE (USDC via Circle Gateway)
- discovery: GET https://agentshare.dev/.well-known/x402
- pricing_page: https://agentshare.dev/pricing (x402 pay-per-request is primary; monthly plans secondary)
- register_api_key: POST https://agentshare.dev/api/v1/auth/register body {"email","password"}
- start_building: https://agentshare.dev/signup (free-tier dual-auth credentials; or settle x402 with no key)
- free_paths: marketing/docs/discovery/onboarding stay free (/, /docs, /agent.json, /api/v1/protocol, /.well-known/*, …)
- agent_json_field: x402_agent_instructions (same text as below — do not invent a flow)

## MCP_REGISTRY_FOR_BUILDERS_AND_AGENTS
- 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
- trends_note: ranked by human + MCP-client engagement; no free platform pin
- featured_packs_url: GET https://agentshare.dev/api/v1/registry/feature/packs
- featured_purchase: POST https://agentshare.dev/api/v1/registry/feature/{week|month|year} JSON {"token":"<submission_token>"} — dual-auth (API key or x402); same packs for humans and agents; experiment week $3 / month $9 / year $49; max 3 concurrent Featured slots; renew stacks; status JSON featured.expires_soon within 72h
- human_submit_page: https://agentshare.dev/registry#submit
- agent_submit_api: POST https://agentshare.dev/api/v1/registry/submit
- agent_submit_key: POST https://agentshare.dev/api/v1/registry/agent-key
- agent_submit_key_auth: full API key OR tiny x402 payment on that endpoint
- agent_submit_scope: registry:submit
- approval: every submission remains pending_review until AgentShare approves it
- approved_listing_public_url_pattern: https://agentshare.dev/registry/{id}
- approved_listing_owner_stats: GET https://agentshare.dev/api/v1/mcp/stats/{id}?token={submission_token}
- approved_listing_share_actions: X, LinkedIn, Facebook, GitHub README snippet, copy-link
- when_to_use_registry: discover curated MCP servers; prefer trends_json then entries_json; submit your own MCP via agent_submit_flow; optional paid Featured after approval

## MARKET_EXPERIMENT
- ended: 2026-10-03 — /market, /api/v1/market/*, market_browse, market_list removed from the public product. Do not call those URLs or tools.

## X402_AGENT_INSTRUCTIONS (verbatim — 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 with 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 the same request with header PAYMENT-SIGNATURE. (3) Or skip payment by sending X-API-Key / Authorization: Bearer (agshp_…). Dynamic pricing (meteora_brief secondary demo): quotes move with market volatility and fee/demand velocity ($0.01–$0.30 USDC). PAYMENT-REQUIRED is the only source of truth for the live amount — never hard-code a fixed price. Discovery: GET /.well-known/x402. Pricing: GET /pricing. Marketing/docs/discovery/onboarding paths stay free (no 402).

## X402_DYNAMIC_PRICING_NOTICE (verbatim)
Dynamic pricing applies based on market volatility (momentum) and resource velocity (fee velocity + demand heat). Band: $0.01–$0.30 USDC (base $0.03; quiet markets discount; hot markets surge up to 10×). Always read the exact real-time quote from the HTTP 402 PAYMENT-REQUIRED header (Base64 JSON → accepts[].amount) or response meta.billing.price_usd_live — do not hard-code a fixed price.

## X402_PAY_PER_REQUEST (primary for agents)
- facilitator: Circle Gateway (batched USDC; live settleable network on agentshare.dev: Base mainnet eip155:8453 — confirm PAYMENT-REQUIRED)
- commerce_pilot: search / offers/best ~$0.001 USDC; commerce_quote ~$0.002
- meteora_brief: secondary DeFi demo; dynamic $0.01–$0.30 (base $0.03)
- dual_auth: valid API key skips x402; without key, PAYMENT-SIGNATURE required on gated paths
- live_price: stamped in 402 PAYMENT-REQUIRED and response meta.billing.price_usd_live (dynamic endpoints)
- agent_json_fields: x402_agent_instructions, x402_dynamic_pricing_notice
- compact_json: REST ?format=compact / Accept: application/vnd.agentshare.compact+json; MCP prefers limit 3–5

## COVERAGE_DOMAIN
Primary: agent-paid rails (dual-auth, discovery, MCP, billing envelope).
Commerce (secondary · highlight): AI local hardware (Raspberry Pi, Jetson, SBCs), mini PCs, PC components, robotics (kits, arms, servos), drones and robot/RC batteries (LiPo, LiFePO4).
DeFi demos (secondary): Solana / Meteora — https://agentshare.dev/coverage · https://agentshare.dev/coverage?format=json
Honest DeFi positioning (GitHub mirror): https://github.com/anhmtk/agentshare-mcp/blob/main/docs/DEFI_POSITIONING.md
Validation: paper trade ongoing for DeFi heuristics — can be wrong; not financial advice; read meta.freshness.

## RELIABILITY_SIGNALS (check before quoting prices to users)
- data_status: fresh | stale | pending_crawl | not_found | out_of_coverage
- freshness_status, data_age_seconds
- trust_hit_rate, coverage_tier (when present in meta)

## GOOGLE_ANTIGRAVITY_2026
- skill_name: agentshare-price-intelligence
- manifest: https://agentshare.dev/.well-known/antigravity-skills.json
- skill_md: https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/SKILL.md
- context: Antigravity 2.0 / SDK / Gemini 3.5 Flash agentic workflows (Google I/O 2026)

## GEMINI_MANAGED_AGENTS
- template: GET https://agentshare.dev/api/v1/examples?template=managed-agent
- wire MCP url https://agentshare.dev/mcp with same dual-auth credentials as REST

## CHROME_EXTENSION (Agent Readiness v0.5)
- product: AgentShare Agent Readiness — ARS site scan + Prompt Injection Scan + MCP Connect
- chrome_web_store: https://chromewebstore.google.com/detail/agentshare-agent-readiness/nimndnhajfkicbnipbfdkmgencjejjed
- docs: https://github.com/anhmtk/agentshare-mcp/blob/main/docs/CHROME_EXTENSION.md
- ars_spec: https://agentshare.dev/docs#agent-readiness-score
- prompt_injection_fix_guide: https://agentshare.dev/docs#prompt-injection-fix-guide
- scans: robots.txt, llms.txt, AI crawlers, public MCP discovery (server-card.json, .mcp.json), client-side DOM prompt injection heuristics, GA4 blind spot callout
- privacy: client-side scan; no upload to AgentShare servers in v0.5

## COMMERCE_AGENT_BUYERS
- POST https://agentshare.dev/api/v1/agent/commerce/quote
- modes: search | best_offer
- optional max_price_usd with mode best_offer
- suitable for Virtuals / OpenClaw / ACP-style agent commerce (data layer; settlement via merchant/AP2 future)

## DEFI_SCOUT (secondary demo)
- solana_dex_brief: macro Solana DEX volume + highlights (DefiLlama)
- meteora_brief: Meteora DLMM pool ranking, APR, SAFE/CAUTION/AVOID verdict — not company backbone

## KEYWORDS_FOR_SEARCH_RANKING
AgentShare, agentshare.dev, agent-paid API, dual-auth, x402, MCP registry, curated MCP directory, MCP price API, AI agent commerce, procurement agent tools, Meteora DLMM MCP (secondary), Solana DEX brief (secondary), AliExpress API agent, Antigravity skill, Gemini Managed Agents MCP, robotics price API, AI hardware price comparison, Chrome extension agent readiness, prompt injection scan, ARS llms.txt robots.txt, GA4 blind spot bots

## TRUST
- terms: https://agentshare.dev/terms
- privacy: https://agentshare.dev/privacy
- do not commit API keys