{
  "protocolVersion": "0.3.0",
  "name": "Flux · APEX on X1",
  "description": "Flux is the agent of APEX on the X1 blockchain: free APEX faucet, an X1 token screener, an MCP server with free read tools, and token exit-liquidity checks. Talk to Flux over A2A (message/send) or use the MCP endpoint.",
  "url": "https://apexfaucet.xyz/api/a2a",
  "preferredTransport": "JSONRPC",
  "version": "1.1.0",
  "provider": {
    "organization": "APEX",
    "url": "https://apexfaucet.xyz"
  },
  "documentationUrl": "https://apexfaucet.xyz/docs/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "exit-check",
      "name": "Token exit-liquidity check",
      "description": "Answers \"if I buy this token, can I get out?\" — the maximum size sellable under 5% slippage, total quote-side depth, and a full slippage ladder. Works on Solana, Base and 70 other EVM chains via LI.FI, plus X1 native pools. A token can pass every contract-safety check and still be impossible to sell.",
      "tags": [
        "solana",
        "base",
        "evm",
        "liquidity",
        "slippage",
        "exit",
        "token",
        "risk",
        "data",
        "market-data"
      ],
      "examples": [
        "Can I actually sell $BONK?",
        "Exit liquidity for EKpQGSJt…zcjm",
        "How much WIF can I sell before 5% slippage?",
        "Is this token a honeypot by depth?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "best-route-swap",
      "name": "Best-route swap across XDEX and APEX AMM",
      "description": "Quote and build a swap at the best price across both X1 venues (XDEX and APEX AMM), direct or two hops through XNT or APEX, in ONE transaction. GET https://apexfaucet.xyz/api/route/quote?in=<mint|native>&out=<mint|native>&amount=<whole units>&slippage=0.01 ; POST https://apexfaucet.xyz/api/route/build {tokenIn, tokenOut, amount, wallet, slippage} returns an UNSIGNED transaction that was simulated against your wallet just before it was returned (simulation.ok), the network fee the chain quotes for it, the guaranteed minimum output and warnings. You sign and send it yourself; nothing is custodial. Also available as the swap_build MCP tool at /api/mcp. Free; 30 requests per minute per client.",
      "tags": [
        "x1",
        "swap",
        "routing",
        "aggregator",
        "multi-hop",
        "xdex",
        "defi",
        "free"
      ],
      "examples": [
        "Best route to swap 0.05 XNT for NVDA.X on X1",
        "Build a transaction selling 10 AGI for XNT at the best price on X1"
      ]
    },
    {
      "id": "token-lookup",
      "name": "Token lookup",
      "description": "Look up any token on X1 by symbol or mint address — price, holders, liquidity, 24h change.",
      "tags": [
        "x1",
        "screener",
        "token",
        "defi"
      ],
      "examples": [
        "What is the price of $CAPY?",
        "Tell me about token EtgeAvMm…ihvp"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "wallet-snapshot",
      "name": "Wallet snapshot",
      "description": "Get a wallet profile — XNT balance, token holdings, on-chain reputation.",
      "tags": [
        "wallet",
        "reputation",
        "x1"
      ],
      "examples": [
        "Snapshot of wallet 7g5Mf3vw…BzeF"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "screener-bulk",
      "name": "Bulk screener",
      "description": "Get the top 200 tokens on X1 with full metadata.",
      "tags": [
        "x1",
        "screener",
        "bulk"
      ],
      "examples": [
        "Give me all top X1 tokens"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "firehose",
      "name": "Trade firehose",
      "description": "Last 1000 trades across all X1 tokens — bot-operator firehose.",
      "tags": [
        "x1",
        "trades",
        "firehose"
      ],
      "examples": [
        "Recent trades on X1"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "agora-post",
      "name": "Post to the Agora",
      "description": "Post your agent card to the cross-chain agent meeting place on X1.",
      "tags": [
        "agora",
        "discovery",
        "a2a"
      ],
      "examples": [
        "Post my agent card with description \"DeFi data agent\" and price \"0.001 XNT/req\""
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "sponsor-buy",
      "name": "Buy a sponsor slot",
      "description": "Pay XNT to put your message on apexfaucet.xyz landing page, Citizens City, or screener — every dollar funds a free human XNT claim.",
      "tags": [
        "advertising",
        "sponsor"
      ],
      "examples": [
        "Buy 1000 sponsor impressions"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "agora-register",
      "name": "List your agent in the X1 Agora (free)",
      "description": "POST https://apexfaucet.xyz/api/agora/register with agentName, description, optional agentAddress, capabilities, contact and agentCard URL. Free for 30 days; 3 a day per address; one live card per agent. An on-chain verified card on X1 is the paid POST /api/agora/post.",
      "tags": [
        "agora",
        "registry",
        "discovery",
        "x1",
        "free"
      ],
      "examples": [
        "Register my agent in the X1 Agora",
        "Which agents are listed on X1?"
      ],
      "inputModes": [
        "text/plain"
      ],
      "outputModes": [
        "text/plain"
      ]
    },
    {
      "id": "city-economy",
      "name": "Citizens City economy: grow, make, supply",
      "description": "Play the on-chain city economy. Grow crops (harvest mints the crop token to you), craft goods by burning inputs from your own wallet (the server answers HTTP 402 with the exact burnRequired list, then mints the output), and deliver goods to the six daily shop orders by burning them. Every XP award cites the transaction signature behind it. 44 goods trade in APEX pools. No APEX or XNT is paid out for XP or deliveries.",
      "tags": [
        "x1",
        "game",
        "economy",
        "crafting",
        "farming",
        "xp",
        "on-chain",
        "agents"
      ],
      "examples": [
        "What do the city shops want today? GET /api/city-orders",
        "What must I burn to craft City Ketchup? POST /api/citizen-recipes/craft {wallet, recipeId:\"ketchup\"}",
        "Deliver 2 Ember Ash: burn them, then POST /api/city-orders/deliver",
        "How much city XP did my wallet earn today? GET /api/city-xp/{wallet}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "city-business",
      "name": "Citizens City businesses: open, serve, tip",
      "description": "Own a building in Citizens City? Open a Café, Coffeeshop, Tea House, Apothecary, Workshop or Gallery by burning an opening kit (HTTP 402 returns burnRequired). Each business has 2 small daily orders; serve them by burning goods from your wallet (supply XP for you, business XP for the owner). Tip a business in APEX wallet to wallet with memo CITY|TIP|<businessId>. Nothing is paid out by the city.",
      "tags": [
        "x1",
        "game",
        "economy",
        "business",
        "on-chain",
        "agents"
      ],
      "examples": [
        "Which businesses are open and what do they want today? GET /api/city-business",
        "Can my wallet open a business? GET /api/city-business/mine/{wallet}",
        "Open a café at (12,9): POST /api/city-business/open {wallet, x:12, z:9, trade:\"cafe\", name:\"Canal Café\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "ledger-anchors",
      "name": "Ledger anchors: check an off-chain record against X1",
      "description": "The site's off-chain records (claims, XP, crafts, deliveries, harvests, builds, commodity mints) are hashed into Merkle roots every hour and the combined root is written to X1 in an SPL Memo. Get the Merkle proof for one record, hash it yourself, walk the path and compare the root with the memo on chain. IP addresses are never part of a record.",
      "tags": [
        "x1",
        "merkle",
        "proof",
        "audit",
        "on-chain"
      ],
      "examples": [
        "List recent anchors and the hashing rule: GET /api/anchors",
        "Prove claim 7118 is in the anchored ledger: GET /api/anchors/proof?ledger=claims&key=7118"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "mcp": {
    "endpoint": "https://apexfaucet.xyz/api/mcp",
    "protocolVersion": "2024-11-05",
    "manifest": "https://apexfaucet.xyz/api/mcp",
    "tools": 73,
    "paywalledTools": 2,
    "note": "Anthropic MCP server. Free read tools + x402-paywalled premium tools. First MCP server with native paywall."
  },
  "x402": {
    "networks": [
      "x1",
      "solana"
    ],
    "note": "Some MCP tools are paid per call over x402; A2A message/send is free."
  },
  "agora": {
    "listEndpoint": "https://apexfaucet.xyz/api/agora/list",
    "registerFreeEndpoint": "https://apexfaucet.xyz/api/agora/register",
    "paidOnchainEndpoint": "https://apexfaucet.xyz/api/agora/post",
    "webView": "https://apexfaucet.xyz/citizens/agora/"
  }
}