Use the Crius API from AI agents (OpenAPI, llms.txt, MCP)

// crius-tools.mjs: tool definitions from Crius's OpenAPI document (Node.js 22+)
const KEY = process.env.CRIUS_API_KEY; // optional: the anonymous plan covers these endpoints
const spec = await (await fetch("https://api.crius.sh/openapi.json")).json();

const PATHS = [
  "/v1/{chain}/search",
  "/v1/{chain}/token/{address}",
  "/v1/{chain}/token/{address}/price",
  "/v1/{chain}/token/{address}/security",
  "/v1/{chain}/token/{address}/candles",
  "/v1/{chain}/tokens",
];
const toolName = (path) => path.replace("/v1/{chain}", "").replace(/\{\w+\}/g, "").split("/").filter(Boolean).join("_");

export const tools = PATHS.map((path) => {
  const op = spec.paths[path].get;
  const params = op.parameters.filter((p) => p.name !== "chain"); // always Robinhood Chain
  return {
    name: toolName(path), // search, token, token_price, token_security, token_candles, tokens
    description: `Robinhood Chain: ${op.summary}. ${op.description ?? ""}`.trim(),
    path,
    parameters: {
      type: "object",
      properties: Object.fromEntries(params.map((p) => [p.name, { type: p.schema?.type ?? "string", description: p.description || p.name }])),
      required: params.filter((p) => p.required).map((p) => p.name),
    },
  };
});

export async function runTool(name, args) {
  const tool = tools.find((t) => t.name === name);
  let path = tool.path.replace("{chain}", "robinhood");
  const query = new URLSearchParams();
  for (const [k, v] of Object.entries(args ?? {})) {
    if (path.includes(`{${k}}`)) path = path.replace(`{${k}}`, encodeURIComponent(v));
    else if (v != null) query.set(k, String(v));
  }
  const res = await fetch(`https://api.crius.sh${path}${query.size ? `?${query}` : ""}`, { headers: KEY ? { "x-api-key": KEY } : {} });
  const body = await res.json();
  if (!res.ok) return `Crius API error ${res.status} ${body.error?.code}: ${body.error?.message}`; // text the model can act on
  return JSON.stringify({ data: body.data, block: body.meta?.block }).slice(0, 20_000); // trim, and keep the block for citing
}

console.log(tools.map((t) => t.name).join(", "));
console.log((await runTool("token_price", { address: "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec" })).slice(0, 120));

// crius-mcp.mjs: npm i @modelcontextprotocol/sdk@1.32.1 zod@4.6.5, then register "node crius-mcp.mjs" in your MCP client
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const API = "https://api.crius.sh/v1/robinhood";
const KEY = process.env.CRIUS_API_KEY;
const address = z.string().regex(/^0x[0-9a-fA-F]{40}$/).describe("Token address (0x + 40 hex characters)");

async function crius(path) {
  const res = await fetch(`${API}${path}`, { headers: KEY ? { "x-api-key": KEY } : {} });
  const body = await res.json();
  const text = res.ok
    ? JSON.stringify({ data: body.data, block: body.meta?.block }).slice(0, 20_000)
    : `Crius API error ${res.status} ${body.error?.code}: ${body.error?.message}`;
  return { content: [{ type: "text", text }], isError: !res.ok };
}

const server = new McpServer({ name: "crius", version: "1.0.0" });
const ro = { readOnlyHint: true };

server.registerTool("search_tokens", {
  description: "Find Robinhood Chain tokens by name, symbol or address. Symbols are not unique: pick by address.",
  inputSchema: { query: z.string().min(1).max(64) },
  annotations: ro,
}, ({ query }) => crius(`/search?q=${encodeURIComponent(query)}&type=token&limit=10`));

server.registerTool("token_profile", {
  description: "Price, market cap, liquidity, holders summary and launchpad of a Robinhood Chain token.",
  inputSchema: { address },
  annotations: ro,
}, ({ address }) => crius(`/token/${address}`));

server.registerTool("token_security", {
  description: "Security score 0-100, risk level, flags, buy/sell tax and honeypot check of a token.",
  inputSchema: { address },
  annotations: ro,
}, ({ address }) => crius(`/token/${address}/security`));

await server.connect(new StdioServerTransport());