@agnt-id/mcp 0.1.0

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,151 @@
+#!/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 GATEWAY = process.env.AGNT_GATEWAY ?? "https://api.agnt.id";
+const DEFAULT_CHAIN = process.env.AGNT_CHAIN ?? "eip155:1";
+// ── Helpers ──────────────────────────────────────────────────────
+function ensureSuffix(name) {
+    const n = name.trim().toLowerCase();
+    return n.endsWith(".agnt") ? n : `${n}.agnt`;
+}
+async function gw(path) {
+    const res = await fetch(`${GATEWAY}${path}`);
+    if (res.status === 404)
+        return null;
+    if (!res.ok)
+        throw new Error(`gateway ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+function json(data) {
+    return [{ type: "text", text: JSON.stringify(data, null, 2) }];
+}
+// ── Server ───────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "agnt",
+    version: "0.1.0",
+});
+// Tool: resolve_agnt
+server.tool("resolve_agnt", "Resolve a .agnt name to its wallet, agent endpoints (A2A/MCP), identity records, and metadata. Returns null if the name is not registered.", {
+    name: z
+        .string()
+        .describe("The .agnt name or label (e.g. 'alice' or 'alice.agnt')"),
+}, async ({ name }) => {
+    const data = await gw(`/v1/agnt/gateway/resolve/${encodeURIComponent(ensureSuffix(name))}`);
+    if (!data) {
+        return {
+            content: [
+                { type: "text", text: `${ensureSuffix(name)} is not registered.` },
+            ],
+        };
+    }
+    return { content: json(data) };
+});
+// Tool: reverse_agnt
+server.tool("reverse_agnt", "Look up the primary .agnt name for an EVM address. Returns null if no reverse record is set.", {
+    address: z.string().describe("EVM address (0x...)"),
+    chain_id: z
+        .string()
+        .optional()
+        .describe("CAIP-2 chain ID (default: eip155:1)"),
+}, async ({ address, chain_id }) => {
+    const chain = chain_id ?? DEFAULT_CHAIN;
+    const data = await gw(`/v1/agnt/gateway/reverse/${chain}/${address}`);
+    if (!data) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No .agnt name found for ${address} on ${chain}.`,
+                },
+            ],
+        };
+    }
+    return { content: json(data) };
+});
+// Tool: search_agnt
+server.tool("search_agnt", "Search and discover .agnt agents by keyword, skill, or domain. Returns ranked results with trust scores.", {
+    q: z.string().optional().describe("Search query"),
+    skill: z.string().optional().describe("Filter by OASF skill slug"),
+    domain: z.string().optional().describe("Filter by OASF domain slug"),
+    chain_id: z
+        .string()
+        .optional()
+        .describe("CAIP-2 chain ID (default: eip155:1)"),
+    limit: z.number().optional().describe("Max results (1-50, default: 20)"),
+}, async ({ q, skill, domain, chain_id, limit }) => {
+    const url = new URL(`${GATEWAY}/v1/agnt/gateway/discover`);
+    url.searchParams.set("chain_id", chain_id ?? DEFAULT_CHAIN);
+    if (q)
+        url.searchParams.set("q", q);
+    if (skill)
+        url.searchParams.set("skill", skill);
+    if (domain)
+        url.searchParams.set("domain", domain);
+    if (limit)
+        url.searchParams.set("limit", String(limit));
+    const res = await fetch(url.toString());
+    if (!res.ok)
+        throw new Error(`gateway ${res.status}`);
+    const data = await res.json();
+    return { content: json(data) };
+});
+// Tool: check_availability
+server.tool("check_availability", "Check if a .agnt name is available for registration.", { name: z.string().describe("The .agnt name or label to check") }, async ({ name }) => {
+    const full = ensureSuffix(name);
+    const data = (await gw(`/v1/agnt/available/${encodeURIComponent(full)}`));
+    if (!data) {
+        return {
+            content: [
+                { type: "text", text: `Could not check availability for ${full}.` },
+            ],
+        };
+    }
+    const status = data.available ? "available" : "taken";
+    return { content: [{ type: "text", text: `${full} is ${status}.` }] };
+});
+// Tool: owner_names
+server.tool("owner_names", "List all .agnt names owned by an EVM address.", {
+    address: z.string().describe("EVM address (0x...)"),
+    chain_id: z
+        .string()
+        .optional()
+        .describe("CAIP-2 chain ID (default: eip155:1)"),
+    limit: z.number().optional().describe("Max results (1-500, default: 100)"),
+}, async ({ address, chain_id, limit }) => {
+    const url = new URL(`${GATEWAY}/v1/agnt/gateway/owner/${address}`);
+    url.searchParams.set("chain_id", chain_id ?? DEFAULT_CHAIN);
+    if (limit)
+        url.searchParams.set("limit", String(limit));
+    const res = await fetch(url.toString());
+    if (!res.ok)
+        throw new Error(`gateway ${res.status}`);
+    const data = await res.json();
+    return { content: json(data) };
+});
+// Tool: trust_score
+server.tool("trust_score", "Get the trust score and reputation signals for a .agnt name.", {
+    name: z.string().describe("The .agnt name or label"),
+    chain_id: z
+        .string()
+        .optional()
+        .describe("CAIP-2 chain ID (default: eip155:1)"),
+}, async ({ name, chain_id }) => {
+    const full = ensureSuffix(name);
+    const url = new URL(`${GATEWAY}/v1/agnt/gateway/trust/${encodeURIComponent(full)}`);
+    url.searchParams.set("chain_id", chain_id ?? DEFAULT_CHAIN);
+    const res = await fetch(url.toString());
+    if (!res.ok)
+        throw new Error(`gateway ${res.status}`);
+    const data = await res.json();
+    return { content: json(data) };
+});
+// ── Start ────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("agnt-mcp fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@agnt-id/mcp",
+  "version": "0.1.0",
+  "description": "MCP tool server for resolving .agnt names",
+  "type": "module",
+  "bin": {
+    "agnt-mcp": "dist/server.js"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": ["agnt", "mcp", "agent", "naming", "resolve", "model-context-protocol"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}