Agent-paid · dual-auth · x402 · MCP Streamable HTTP

API access built for agents that pay — and discover without HTML

AgentShare is an agent-paid API: call with an API key or settle HTTP 402/x402, keep discovery free (agent.json, /.well-known/x402), and use MCP at /mcp. Secondary modules on the same rails: commerce procurement and Solana/Meteora DeFi demos (Lab-validated — not the company backbone).

Start building agent-paid APIs agent.json MCP /mcp

Commerce: search, best_offer, commerce_quote on dual-auth rails
Free discovery: agent.json, /.well-known/x402, MCP catalog
DeFi demos (secondary): Meteora briefs with meta.freshness + meta.billing

What AgentShare provides

One API key on REST or MCP (or settle x402). Primary: agent-paid rails + discovery. Highlighted secondary: commerce procurement (search / best / quote). Also secondary: Solana/Meteora DeFi demos (Lab — not backbone). Built for human-not-present workflows where opaque auth costs reputation.

Procurement agents

Compare listings, enforce budgets with best_offer_under_budget, product_detail, commerce_quote.

Dev / vibe coding

Antigravity skill + Managed Agents JSON — copy, paste, ship without wiring parsers yourself.

DeFi agents (demo)

Rank pools via meteora_brief, drill into bins with meteora_pool_detail. Check meta.freshness.tier before acting — secondary module.

Google Antigravity skill

Install the official agentshare-price-intelligence skill so Antigravity (or compatible harnesses) auto-invokes MCP tools for DeFi briefs and commerce quotes.

One-click install (bash)

Global install (recommended for Antigravity desktop):

mkdir -p ~/.gemini/antigravity/skills/agentshare-price-intelligence && curl -fsSL https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/SKILL.md -o ~/.gemini/antigravity/skills/agentshare-price-intelligence/SKILL.md

Or curl the published skill from production:

curl -fsSL https://agentshare.dev/integrations/antigravity/agentshare-price-intelligence/SKILL.md | tee ~/.gemini/antigravity/skills/agentshare-price-intelligence/SKILL.md

Manifest: https://agentshare.dev/.well-known/antigravity-skills.json · Skill file: SKILL.md · MCP template: mcp-config.json

Gemini Managed Agents integration

Copy the JSON below into your Managed Agent / tool configuration, or fetch it programmatically: GET https://agentshare.dev/api/v1/examples?template=managed-agent

{
  "schema_version": "1.0",
  "template": "managed-agent",
  "description": "Wire AgentShare MCP into a managed or autonomous agent. Replace YOUR_KEY with agshp_… from /signup.",
  "base_url": "https://agentshare.dev",
  "discovery": {
    "agent_json": "https://agentshare.dev/agent.json",
    "antigravity_skills": "https://agentshare.dev/.well-known/antigravity-skills.json",
    "mcp_server_card": "https://agentshare.dev/.well-known/mcp/server-card.json",
    "for_agents": "https://agentshare.dev/for-agents"
  },
  "managed_agent_config": {
    "model_hint": "gemini-3.5-flash",
    "instructions": "You are a procurement agent for AI hardware and robotics. Use AgentShare MCP tools for price search, best offers, product detail, and commerce_quote. Respect meta.data_status before quoting prices.",
    "mcp": {
      "transport": "streamable_http",
      "url": "https://agentshare.dev/mcp",
      "headers": {
        "X-API-Key": "${AGENTSHARE_API_KEY}",
        "Authorization": "Bearer ${AGENTSHARE_API_KEY}"
      }
    },
    "tools_recommended": [
      "search_products",
      "best_offer",
      "best_offer_under_budget",
      "product_detail",
      "commerce_quote",
      "service_meta"
    ]
  },
  "env": {
    "AGENTSHARE_API_KEY": "YOUR_KEY"
  }
}

Replace YOUR_KEY with your agshp_… key.

MCP tools

Streamable HTTP: https://agentshare.dev/mcp — same X-API-Key as REST. Live catalog: GET /api/v1/mcp/tools · Server card: /.well-known/mcp/server-card.json

`dex_overview`

DEX overview (24h volume)

Rank DEX protocols by 24h volume or 1d change via DefiLlama (read-only macro scout).

`dex_top_movers`

DEX top movers (24h volume change)

Largest absolute 1d volume % change among liquid DEX protocols (DefiLlama).

`solana_dex_brief`

Solana DEX ecosystem brief

Protocol-level Solana DEX intelligence (Raydium, Orca, Meteora, …): volume, 24h change, verdict/risk from DefiLlama aggregates.

`meteora_brief`

Meteora DLMM pool brief

Evidence-first Meteora DLMM pool brief: top pools by fee/TVL, volume, APR; Tier-A momentum_score, fee_velocity, bin_step_risk_tier; verdict SAFE/CAUTION/AVOID. Dynamic x402 pricing ($0.01–$0.30): exact USDC quote is in PAYMENT-REQUIRED on HTTP 402 and in meta.billing.price_usd_live — never assume a fixed price.

`meteora_pool_detail`

Meteora DLMM pool detail

Pool detail v2: price_unit + mints/pair_label, range_health (never fake 0), derived active_bin_id + suggested_spot_range (band_bps), fee signals, ohlcv stub. Optional wallet_address for LP portfolio slice.

`search_products`

Search product listings

Multi-listing search with prices, sources, and freshness metadata. Use to compare options.

`best_offer`

Best single offer

Single cheapest in-stock offer for a product intent — one clear recommendation.

`best_offer_under_budget`

Best offer under budget

Best deal within a max price (budget / “under $X”). Same unit as currency (USD or VND).

`product_detail`

Product detail by ID

Full product + per-source prices when you already have a product_id from search.

`commerce_quote`

Commerce quote (ACP)

Stable agentshare.price.v1 envelope for autonomous buyers (search or best_offer mode).

`service_meta`

Service metadata

Capabilities, rate limits, and integration hints (REST meta; MCP connect still needs your key).

Agent quickstart (no key)

GET /agent.json — tools, auth, error contract
GET /api/v1/examples — curl / Python / JS snippets
GET /api/v1/protocol — envelopes & AX error fields
Register — free tier (~100 req/month)

curl -sS -X POST "https://agentshare.dev/api/v1/agent/defi/meteora/brief" \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"top_pools","limit":5}'

Built for parallel agent load

Production SQLite runs WAL mode with busy_timeout=5000ms so concurrent MCP tool loops avoid database is locked under burst traffic.

When something fails

Errors return JSON agents can act on — not opaque HTML:

401 — signup_url, suggestion
429 — retry_after_seconds, Retry-After header
404 — correct /api/v1/… paths in suggestion

Full contract: https://agentshare.dev/api/v1/protocol · Coverage: /coverage