madeonsol_token_get
Read-onlyIdempotent
Retrieve a token's comprehensive snapshot: VWAP price, market cap, 24h volume, deployer reputation, KOL activity, age, and blacklist status. Optionally includes top buyer KOL wallet addresses.
Instructions
Comprehensive per-mint snapshot: price (VWAP), market cap, 24h volume, deployer reputation, KOL smart-money activity, first_seen_at + age_seconds, and blacklist status — all in one call. ULTRA adds individual KOL wallet addresses in top_buyers[].
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mint | Yes | Token mint address (base58) |
Implementation Reference
- src/index.ts:656-664 (registration)Tool registration using server.tool() with name 'madeonsol_token_get'. Registered inside the webhook/streaming section (requires MADEONSOL_API_KEY). The schema accepts a single 'mint' parameter (base58 token address).
server.tool( "madeonsol_token_get", "Comprehensive per-mint snapshot: price (VWAP), market cap, 24h volume, deployer reputation, KOL smart-money activity, first_seen_at + age_seconds, and blacklist status — all in one call. ULTRA adds individual KOL wallet addresses in top_buyers[].", { mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async ({ mint }) => ({ content: [{ type: "text" as const, text: await restQuery("GET", `/token/${encodeURIComponent(mint)}`) }], }) ); - src/index.ts:661-663 (handler)Handler function for madeonsol_token_get. Takes { mint } from args and calls await restQuery('GET', `/token/${encodeURIComponent(mint)}`) to fetch a comprehensive per-mint snapshot from the MadeOnSol API. Returns the result as text content.
async ({ mint }) => ({ content: [{ type: "text" as const, text: await restQuery("GET", `/token/${encodeURIComponent(mint)}`) }], }) - src/index.ts:659-660 (schema)Input schema: requires a single 'mint' parameter of type string (z.string()), described as 'Token mint address (base58)'. No output schema defined (raw JSON text).
{ mint: z.string().describe("Token mint address (base58)") }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }, - src/index.ts:451-466 (helper)The restQuery helper function used by the handler. It makes an authenticated HTTP request to the MadeOnSol API (BASE_URL + /api/v1{path}) with the given method and optional body, requiring MADEONSOL_API_KEY auth mode.
async function restQuery(method: string, path: string, body?: unknown): Promise<string> { const headers: Record<string, string> = { "Content-Type": "application/json", ...apiKeyHeaders(), }; const res = await fetch(`${BASE_URL}/api/v1${path}`, { method, headers, ...(body ? { body: JSON.stringify(body) } : {}), }); if (!res.ok) { const text = await res.text().catch(() => ""); return `Error ${res.status}: ${text}`; } return JSON.stringify(await res.json(), null, 2); }