Onchain tools for AI agents on Solana

Show me

From agent question to onchain tool call

The API-key path: the MCP server started with MADEONSOL_API_KEY. One question, two tool calls, real tool names and schemas. Values are illustrative and match the token risk example.

1. 1 · API-key path: the agent picks a tool

   Asked "check 9kQuW3...pump and who made it", the model finds madeonsol_token_risk in the tool list: one required argument, marked read-only.

   tools/list entry the agent sees (abridged)

   {
     "name": "madeonsol_token_risk",
     "description": "Transparent 0–100 token risk score (higher = riskier): risk evidence for your own policy, not a verdict. …",
     "inputSchema": {
       "type": "object",
       "properties": {
         "mint": { "type": "string", "description": "Token mint address (base58)" }
       },
       "required": ["mint"]
     },
     "annotations": {
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
       "openWorldHint": true
     }
   }

2. 2 · The server calls MadeOnSol

   The client sends tools/call and the server calls the /api/v1 route with your key. madeonsol_token_risk is not registered in keyless x402 mode; keyless, the same route is reached through the madeonsol-x402 client (see the x402 section).

   The call, and the request the server makes

   // MCP client → mcp-server-madeonsol (JSON-RPC over stdio)
   {
     "jsonrpc": "2.0",
     "id": 7,
     "method": "tools/call",
     "params": {
       "name": "madeonsol_token_risk",
       "arguments": { "mint": "9kQuW3...pump" }
     }
   }
   // mcp-server-madeonsol → MadeOnSol, with MADEONSOL_API_KEY set:
   // GET https://madeonsol.com/api/v1/tokens/9kQuW3...pump/risk
   // Authorization: Bearer msk_...

3. 3 · The agent reads fields, not prose

   6 factors added points, and LP custody is listed as not assessed. The agent can quote the evidence and see that the creator sold most of its self-buy.

   result.content[0].text, parsed (abridged)

   // The tool returns one text block: the endpoint's JSON, as a string.
   {
     "mint": "9kQuW3...pump",
     "risk_score": 47,
     "band": "caution",
     "factors": [
       {
         "key": "liquidity",
         "status": "warn",
         "points": 8,
         "detail": "Low liquidity ($6,400)."
       },
       {
         "key": "liquidity_ratio",
         "status": "warn",
         "points": 5,
         "detail": "Liquidity is 3.1% of market cap."
       },
       {
         "key": "lp_burn",
         "status": "warn",
         "points": 8,
         "detail": "LP burn/lock status unknown …"
       },
       {
         "key": "bundled_open",
         "status": "warn",
         "points": 6,
         "detail": "Elevated launch concentration (27.4 SOL in the first 20 buyers)."
       },
       {
         "key": "deployer_reputation",
         "status": "danger",
         "points": 12,
         "detail": "Deployer has bonded only 4% of 50 tokens."
       },
       {
         "key": "kol_distribution",
         "status": "warn",
         "points": 8,
         "detail": "Tracked KOLs are net-distributing this token."
       }
     ],
     "assessment": {
       "status": "complete",
       "unknown_inputs": [],
       "not_assessed": [
         "lp_custody"
       ]
     },
     "score_version": "v2",
     "dev": {
       "wallet": "7Dv4tP...Qm2e",
       "buy_tokens": 34120000,
       "sold_tokens": 30000000,
       "wallet_empty": false,
       "transfer_status": "none_detected"
     },
     "as_of": "2026-09-25T10:00:00.000Z"
   }

4. 4 · It follows a field

   dev.wallet becomes the argument of madeonsol_deployer_profile: the creator's record, available on a Free key.

   madeonsol_deployer_profile, called with dev.wallet (abridged)

   // tools/call madeonsol_deployer_profile { "wallet": "7Dv4tP...Qm2e" }
   // → GET /api/v1/deployer-hunter/7Dv4tP...Qm2e
   {
     "deployer": {
       "wallet_address": "7Dv4tP...Qm2e",
       "tier": "cold",
       "is_tracked": false,
       "total_tokens_deployed": 50,
       "total_bonded": 2,
       "instant_bonds": 0,
       "bonding_rate": 0.04,
       "recent_bond_rate": 0,
       "recent_outcomes": "DDDDDDDDDD",
       "runner_rate": 0,
       "last_deploy_at": "2026-09-25T09:31:07.000Z"
     }
   }

Who does what in that exchange

1. 1 · Agent

   Question

   A user or a task asks about a mint, a wallet or a creator.

3. 2 · Agent

   Tool choice

   The model reads the tool list and fills in the arguments.

5. 3 · MadeOnSol

   MCP call

   With a key, the server calls the /api/v1 endpoint. In x402 mode, only the keyless tools exist and each call is paid.

7. 4 · MadeOnSol

   Structured result

   Named fields, factor points and what could not be observed.

9. 5 · Agent

   Agent reasoning

   The agent follows a field, answers, or asks the user. It never trades through MadeOnSol.

MCP

What the MCP server exposes

mcp-server-madeonsol has 104 tools, each a thin wrapper over one MadeOnSol endpoint. Which of them register depends on how you authenticate. Install steps and client configs live on the MCP page.

Keyless tools: madeonsol_kol_feed, madeonsol_kol_coordination, madeonsol_kol_leaderboard, madeonsol_deployer_alerts, madeonsol_kol_pairs, madeonsol_deployer_trajectory, madeonsol_kol_hot_tokens, madeonsol_kol_token_entry_order, madeonsol_kol_compare_wallets, madeonsol_kol_alerts_recent, madeonsol_kol_trending_tokens, madeonsol_sniper_recent.

Listed in x402 mode but need a key (they answer with an error text): madeonsol_kol_timing, madeonsol_deployer_stats, madeonsol_deployer_leaderboard, madeonsol_deployer_profile, madeonsol_deployer_tokens, madeonsol_deployer_alert_stats, madeonsol_deployer_best_tokens, madeonsol_deployer_recent_bonds, madeonsol_kol_pnl, madeonsol_sniper_by_deployer, madeonsol_sniper_watchlist_list, madeonsol_sniper_watchlist_add, madeonsol_sniper_watchlist_remove.

Tool families, with real names

What it does not do

x402

When the agent pays per call

MCP decides how an agent calls a tool; x402 decides how one HTTP request gets paid. 25 Solana routes take USDC per call, from $0.005 to $0.02, with no account. The full catalog and protocol notes are on the x402 page.

1. 1 · Request

   The agent sends a plain GET to an /api/x402 route. No key, no account.

2. 2 · HTTP 402

   The answer names the scheme, network, asset, amount and payee in accepts[], in the body and base64 in a header.

   PAYMENT-REQUIRED

3. 3 · Pay and retry

   The client checks the offer against its own policy, signs a USDC payment and repeats the request with the proof.

   PAYMENT-SIGNATUREX-PAYMENT

4. 4 · Data

   The payment is verified and settled, then the route answers with the same JSON as its /api/v1 twin.

   PAYMENT-RESPONSE

Which keyless client reaches what

// GET /api/x402/tokens/9kQuW3...pump/risk, no payment
// amount is atomic USDC (6 decimals): 20000 = $0.02
{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://madeonsol.com/api/x402/tokens/9kQuW3...pump/risk",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "amount": "20000",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "payTo": "GLu63pRCYrp4BJu5P5ciYKxgeZFW9c8TJ8jWzK3TB9AR",
      "maxTimeoutSeconds": 60,
      "extra": {
        "feePayer": "2wKupLR9q6wXYppw8Gr2NvWxKBUqm4PPJKkQfoxHDBg4"
      }
    }
  ]
}
// + description, outputSchema and extensions.bazaar (discovery metadata)

import { MadeOnSolX402 } from "madeonsol-x402";

// Required before the client signs anything: who may be paid, and how much.
const agent = new MadeOnSolX402({
  privateKey: process.env.SVM_PRIVATE_KEY!,
  paymentPolicy: {
    payTo: "GLu63p...B9AR",          // merchant, from /x402, not from the 402
    feePayer: "2wKupL...xHDBg4",      // facilitator fee payer
    maxAmountAtomic: "20000",        // per call (0.02 USDC)
    maxTotalAmountAtomic: "1000000", // per client instance (1 USDC)
    rpcUrl: process.env.SVM_RPC_URL!,
  },
});

// GET /api/x402/tokens/{mint}/risk: 402, pay within policy, retry, JSON.
const risk = await agent.tokenRisk("9kQuW3...pump");

Routes an agent pays for most

Architecture choice

MCP, x402 or your own backend

An agent does not have to use MCP. The same endpoints serve every route; pick by where the agent runs and who holds the credential.

import { MadeOnSolREST } from "madeonsol-x402";

const rest = new MadeOnSolREST({ apiKey: process.env.MADEONSOL_API_KEY! });

// Register this in your agent framework's tool format.
export const checkToken = {
  name: "check_token",
  description: "Risk factors and creator record for one Solana mint",
  input: { mint: "string" },
  async run({ mint }: { mint: string }) {
    const risk = await rest.tokenRisk(mint);             // GET /api/v1/tokens/{mint}/risk
    const creator = risk.dev?.wallet
      ? await rest.deployerProfile(risk.dev.wallet)      // GET /api/v1/deployer-hunter/{wallet}
      : null;
    return { band: risk.band, factors: risk.factors, assessment: risk.assessment, creator };
  },
};

Plans

What each tool needs

A tool needs the plan of the endpoint it calls. A Free key allows 200 calls a day. x402 is separate from any plan.

Compare plans · API status · Webhooks

Architecture

Where MadeOnSol sits in an agent stack

1. 1 · Source

   Chain activity

   Transactions and program events

3. 2 · MadeOnSol

   Data and intelligence layer

   • MCP tools over the API
   • Structured JSON results
   • Keyed or pay-per-call access

5. 3 · Delivery

   • REST API/api/v1 · what the MCP server calls with a key
   • x402/api/x402 · pay per call, keyless
   • Webhookssigned HTTPS push
   • WebSocket streams/ws/v1/stream

7. 4 · Yours

   Your agent and its model

   Keys and business logic stay server-side

9. 5 · Users

   Answers and actions

• Token research agents
• Wallet investigation agents
• Smart-money research assistants
• Token due-diligence agents
• Market-monitoring agents
• Onchain copilots in Claude or Cursor

An agent that shows MadeOnSol data to your own users is displaying it, which requires a Business plan. See pricing