bytecode-intelligence-mcp 1.0.0

package/README.md

@@ -0,0 +1,65 @@
+# bytecode-intelligence-mcp
+
+MCP server for EVM smart contract bytecode classification. Powered by [byteco.xyz](https://byteco.xyz).
+
+Analyzes hex-encoded EVM bytecode and classifies it as a mixer, token, DEX, proxy, bridge, staking contract, or NFT — with a confidence score.
+
+## Tools
+
+### `analyze_bytecode`
+
+Classifies EVM bytecode and returns a risk label with confidence.
+
+**Input:**
+- `bytecode` (string) — hex-encoded bytecode, with or without `0x` prefix
+- `blockchain` (string, default `"evm"`) — chain family
+
+**Output:**
+```
+Label:      mixer
+Confidence: 91.3%
+Meaning:    Privacy/tumbler contract (e.g. Tornado Cash) — high risk
+
+Family scores:
+  mixer      91.3%
+  proxy      6.1%
+  dex        1.8%
+  ...
+```
+
+**Supported labels:** `mixer`, `erc20`, `erc721`, `proxy`, `dex`, `bridge`, `staking`, `unknown`
+
+### `get_supported_chains`
+
+Lists supported blockchain networks (currently all EVM-compatible chains: Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, Avalanche, and more).
+
+## Usage
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "bytecode-intelligence": {
+      "command": "npx",
+      "args": ["-y", "bytecode-intelligence-mcp"]
+    }
+  }
+}
+```
+
+### Other MCP clients
+
+```bash
+npx bytecode-intelligence-mcp
+```
+
+## API
+
+The server calls [https://byteco.xyz](https://byteco.xyz) — no API key required. Rate limit: 10 req/s per IP.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const API_BASE = "https://byteco.xyz";
+const SUPPORTED_CHAINS = {
+    supported: [
+        {
+            id: "evm",
+            name: "EVM-compatible chains",
+            examples: ["Ethereum", "BSC", "Polygon", "Arbitrum", "Optimism", "Base", "Avalanche"],
+        },
+    ],
+    planned: ["solana", "tron"],
+};
+const CONTRACT_FAMILIES = {
+    mixer: "Privacy/tumbler contract (e.g. Tornado Cash) — high risk",
+    erc20: "Fungible token (ERC-20 standard)",
+    erc721: "Non-fungible token (ERC-721 NFT standard)",
+    proxy: "Upgradeable proxy contract",
+    dex: "Decentralized exchange or AMM",
+    bridge: "Cross-chain bridge contract",
+    staking: "Staking or rewards distribution contract",
+    unknown: "No family matched above confidence threshold",
+};
+const server = new McpServer({
+    name: "bytecode-intelligence",
+    version: "1.0.0",
+});
+server.tool("analyze_bytecode", `Analyze EVM smart contract bytecode to classify its family and assess risk.
+
+Returns a primary label with confidence score, plus ranked scores for all families.
+Families: mixer (Tornado Cash-style), erc20, erc721, proxy, dex, bridge, staking, unknown.
+Confidence below 0.35 returns label "unknown".
+
+Accepts any EVM-compatible chain bytecode (Ethereum, BSC, Polygon, Arbitrum, etc.).
+Bytecode can be provided with or without 0x prefix. Constructor code and Solidity metadata are stripped automatically.`, {
+    bytecode: z
+        .string()
+        .min(2)
+        .describe("Hex-encoded EVM bytecode (with or without 0x prefix)"),
+    blockchain: z
+        .string()
+        .default("evm")
+        .describe("Blockchain network — currently 'evm' for all EVM-compatible chains"),
+}, async ({ bytecode, blockchain }) => {
+    let response;
+    try {
+        response = await fetch(`${API_BASE}/v1/${blockchain}/analyze`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ bytecode }),
+        });
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Network error: ${String(err)}` }],
+            isError: true,
+        };
+    }
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `API error ${response.status}: ${body || response.statusText}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const result = (await response.json());
+    const description = CONTRACT_FAMILIES[result.label] ?? result.label;
+    const familyRows = result.families
+        .sort((a, b) => b.score - a.score)
+        .map((f) => `  ${f.family.padEnd(10)} ${(f.score * 100).toFixed(1)}%`)
+        .join("\n");
+    const summary = [
+        `Label:      ${result.label}`,
+        `Confidence: ${(result.confidence * 100).toFixed(1)}%`,
+        `Meaning:    ${description}`,
+        "",
+        "Family scores:",
+        familyRows,
+    ].join("\n");
+    return {
+        content: [{ type: "text", text: summary }],
+    };
+});
+server.tool("get_supported_chains", "List the blockchain networks supported for bytecode analysis, with examples of compatible chains.", {}, async () => {
+    const lines = [
+        "Supported chains:",
+        ...SUPPORTED_CHAINS.supported.map((c) => `  ${c.id} — ${c.name}\n    Examples: ${c.examples.join(", ")}`),
+        "",
+        `Planned: ${SUPPORTED_CHAINS.planned.join(", ")}`,
+    ];
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "bytecode-intelligence-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for EVM smart contract bytecode classification — detects mixers, DEXs, tokens, proxies, bridges, and more",
+  "keywords": [
+    "mcp",
+    "blockchain",
+    "ethereum",
+    "evm",
+    "smart-contracts",
+    "security",
+    "bytecode",
+    "defi",
+    "web3",
+    "model-context-protocol"
+  ],
+  "author": "Bytecode Intelligence",
+  "license": "MIT",
+  "homepage": "https://byteco.xyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yoav-stezki/bytecode-intelligence-api"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bytecode-intelligence-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}