@true402.dev/mcp-server 0.2.2 → 0.4.0

package/dist/index.js

@@ -21,13 +21,14 @@ const SERVER_URL = process.env.SERVER_URL ?? "https://true402.dev/api";
 const WALLET_PRIVATE_KEY = process.env.WALLET_PRIVATE_KEY;
 const server = new McpServer({
     name: "true402",
-    version: "0.2.2",
+    version: "0.4.0",
 });
 // Register tools
 registerModelsTool(server, SERVER_URL);
 registerChatTool(server, SERVER_URL, WALLET_PRIVATE_KEY);
-// Non-LLM paid stalls: seo_audit, web_extract, link_preview,
-// robots_check, headers_check (all x402-gated, USDC on Base).
+// Non-LLM paid stalls: web utilities (seo_audit, web_extract, link_preview,
+// robots_check, headers_check) + Base on-chain signals (token_safety, new_pairs,
+// liquidity_pulls, whale_swaps) — all x402-gated, USDC on Base.
 registerStallTools(server, SERVER_URL, WALLET_PRIVATE_KEY);
 // Start server with stdio transport
 async function main() {

package/dist/tools/stalls.d.ts

@@ -1,6 +1,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
- * Register all five non-LLM paid stalls (seo_audit, web_extract, link_preview,
- * robots_check, headers_check) on the given MCP server.
+ * Register all nine non-LLM paid stalls on the given MCP server: the web utilities
+ * (seo_audit, web_extract, link_preview, robots_check, headers_check) and the Base
+ * on-chain trading signals (token_safety, new_pairs, liquidity_pulls, whale_swaps).
  */
 export declare function registerStallTools(server: McpServer, baseUrl: string, walletPrivateKey: string | undefined): void;

package/dist/tools/stalls.js

@@ -31,8 +31,9 @@ const urlField = z
     .url()
     .describe("Absolute http(s) URL of the page to process");
 /**
- * Register all five non-LLM paid stalls (seo_audit, web_extract, link_preview,
- * robots_check, headers_check) on the given MCP server.
+ * Register all nine non-LLM paid stalls on the given MCP server: the web utilities
+ * (seo_audit, web_extract, link_preview, robots_check, headers_check) and the Base
+ * on-chain trading signals (token_safety, new_pairs, liquidity_pulls, whale_swaps).
  */
 export function registerStallTools(server, baseUrl, walletPrivateKey) {
     // 1. SEO + GEO audit.
@@ -104,4 +105,118 @@ export function registerStallTools(server, baseUrl, walletPrivateKey) {
         inputSchema: { url: urlField },
         buildBody: ({ url }) => ({ url }),
     });
+    // 6. On-chain token safety — rug/honeypot pre-check for a Base ERC-20.
+    registerStall(server, baseUrl, walletPrivateKey, {
+        toolName: "token_safety",
+        path: "/v1/token-safety",
+        description: "Rug/honeypot safety check for an ERC-20 token on Base (on-chain reads, no " +
+            "API key): ERC-20 conformance, ownership renounce, mint capability, WETH/USDC " +
+            "liquidity depth (Uniswap V3 + Aerodrome), and a buy/sell honeypot simulation " +
+            "(a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to catch " +
+            "tokens you can buy but not sell). Returns a 0-100 score + risk band + flags. " +
+            "PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.",
+        inputSchema: {
+            token: z
+                .string()
+                .regex(/^0x[a-fA-F0-9]{40}$/, "must be a 0x-prefixed 20-byte ERC-20 address")
+                .describe("ERC-20 contract address (0x…) on Base"),
+            chain: z
+                .literal("base")
+                .optional()
+                .describe("Chain to check; only 'base' is supported (default)"),
+        },
+        buildBody: ({ token, chain }) => {
+            const body = { token };
+            if (chain !== undefined)
+                body.chain = chain;
+            return body;
+        },
+    });
+    // 7. New token / new pair detection — recently-created Base DEX pairs.
+    registerStall(server, baseUrl, walletPrivateKey, {
+        toolName: "new_pairs",
+        path: "/v1/base/new-pairs",
+        description: "Recently-created Base DEX pairs (Uniswap V3 + Aerodrome) — fresh token launches for " +
+            "trading/sniper agents. Returns each new token, its quote (WETH/USDC), pool, fee|stable, " +
+            "block and approx age, newest first. Bundle with token_safety for a pre-trade rug/honeypot " +
+            "check. On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a funded " +
+            "wallet on the MCP server.",
+        inputSchema: {
+            since: z.number().int().nonnegative().optional().describe("Only pairs first seen at or after this block"),
+            limit: z.number().int().min(1).max(200).optional().describe("Max pairs to return (1–200, default 50)"),
+            dex: z.enum(["uniswap-v3", "aerodrome"]).optional().describe("Filter by DEX"),
+            withToken: z.boolean().optional().describe("Only token launches (vs all pools); default true"),
+        },
+        buildBody: ({ since, limit, dex, withToken }) => {
+            const body = {};
+            if (since !== undefined)
+                body.since = since;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (dex !== undefined)
+                body.dex = dex;
+            if (withToken !== undefined)
+                body.withToken = withToken;
+            return body;
+        },
+    });
+    // 8. Liquidity-pull / rug alerts — liquidity-removal (Burn) events on tracked Base pools.
+    registerStall(server, baseUrl, walletPrivateKey, {
+        toolName: "liquidity_pulls",
+        path: "/v1/base/liquidity-pulls",
+        description: "Liquidity-pull / rug alerts on Base — liquidity-removal (Burn) events on recently-launched " +
+            "DEX pools (Uniswap V3 + Aerodrome). Returns the pool, token, and WETH/USDC amount removed " +
+            "(the rug magnitude), newest first — an early rug warning. Cross-check the token with " +
+            "token_safety. On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a " +
+            "funded wallet on the MCP server.",
+        inputSchema: {
+            since: z.number().int().nonnegative().optional().describe("Only pulls first seen at or after this block"),
+            limit: z.number().int().min(1).max(200).optional().describe("Max pulls to return (1–200, default 50)"),
+            dex: z.enum(["uniswap-v3", "aerodrome"]).optional().describe("Filter by DEX"),
+            minQuote: z.number().nonnegative().optional().describe("Only removals of at least this much WETH/USDC"),
+        },
+        buildBody: ({ since, limit, dex, minQuote }) => {
+            const body = {};
+            if (since !== undefined)
+                body.since = since;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (dex !== undefined)
+                body.dex = dex;
+            if (minQuote !== undefined)
+                body.minQuote = minQuote;
+            return body;
+        },
+    });
+    // 9. Whale swaps — large ($-value) Base DEX Swap events (whale-follow / copy-trade signal).
+    registerStall(server, baseUrl, walletPrivateKey, {
+        toolName: "whale_swaps",
+        path: "/v1/base/whale-swaps",
+        description: "Recent large ($-value) Base DEX Swap events (whale trades) on tracked pools — a " +
+            "whale-following / copy-trade signal. Returns the pool, dex, token, quote (WETH/USDC), USD " +
+            "size, direction (buy/sell of the non-quote token), block and approx age, newest first. " +
+            "On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a funded wallet " +
+            "on the MCP server.",
+        inputSchema: {
+            min: z.number().nonnegative().optional().describe("Only swaps of at least this USD size (default 10000)"),
+            dex: z.enum(["uniswap-v3", "aerodrome"]).optional().describe("Filter by DEX"),
+            since: z.number().int().nonnegative().optional().describe("Only swaps at or after this block"),
+            limit: z.number().int().min(1).max(200).optional().describe("Max swaps to return (1–200, default 50)"),
+            direction: z.enum(["buy", "sell"]).optional().describe("Filter by trade direction (of the non-quote token)"),
+        },
+        buildBody: ({ min, dex, since, limit, direction }) => {
+            const body = {};
+            if (min !== undefined)
+                body.min = min;
+            if (dex !== undefined)
+                body.dex = dex;
+            if (since !== undefined)
+                body.since = since;
+            if (limit !== undefined)
+                body.limit = limit;
+            if (direction !== undefined)
+                body.direction = direction;
+            return body;
+        },
+    });
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@true402.dev/mcp-server",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "mcpName": "dev.true402/mcp-server",
-  "description": "MCP server for the true402 machine-native marketplace — pay-per-call AI + web tools over x402 (USDC on Base): LLM inference, SEO/GEO audit, web extract, link preview, robots/AI-crawler check, security headers.",
+  "description": "MCP server for the true402 machine-native marketplace — pay-per-call AI + web + Base on-chain tools over x402 (USDC on Base): LLM inference, SEO/GEO audit, web extract, link preview, robots/AI-crawler check, security headers, and on-chain DeFi trading signals (token rug/honeypot safety, new token pairs, liquidity-pull/rug alerts, whale swaps).",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -31,7 +31,12 @@
     "seo",
     "geo",
     "web-scraping",
-    "tools"
+    "tools",
+    "defi",
+    "trading",
+    "onchain",
+    "rug-check",
+    "honeypot"
   ],
   "homepage": "https://true402.dev",
   "license": "MIT",