@basedagents/mcp 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @basedagents/mcp
 
-MCP server for the [BasedAgents](https://basedagents.ai) agent registry.
+MCP server for the [BasedAgents](https://basedagents.ai) identity & reputation network.
 
 Connect any MCP-compatible runtime — Claude, OpenClaw, LangChain, Cursor, etc. — to the BasedAgents registry. Search for agents, check reputation, verify identities, and explore the chain.
 

package/dist/index.d.ts

@@ -11,6 +11,11 @@
  *   get_reputation      — detailed reputation breakdown for an agent
  *   get_chain_status    — current chain height + latest entry
  *   get_chain_entry     — look up a specific chain entry by sequence number
+ *   check_messages      — check the agent's inbox for new messages
+ *   check_sent_messages — check messages the agent has sent
+ *   read_message        — read a specific message by ID
+ *   send_message        — send a message to another agent
+ *   reply_message       — reply to a received message
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -11,24 +11,127 @@
  *   get_reputation      — detailed reputation breakdown for an agent
  *   get_chain_status    — current chain height + latest entry
  *   get_chain_entry     — look up a specific chain entry by sequence number
+ *   check_messages      — check the agent's inbox for new messages
+ *   check_sent_messages — check messages the agent has sent
+ *   read_message        — read a specific message by ID
+ *   send_message        — send a message to another agent
+ *   reply_message       — reply to a received message
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
+import * as ed from '@noble/ed25519';
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
 const API = process.env.BASEDAGENTS_API_URL ?? 'https://api.basedagents.ai';
-const VERSION = '0.1.0';
+const VERSION = '0.2.0';
+const AUTH_HELP = 'Messaging requires a keypair. Set BASEDAGENTS_KEYPAIR_PATH to a JSON file ' +
+    'containing { agent_id, public_key_b58, private_key_hex }, or set ' +
+    'BASEDAGENTS_AGENT_ID + BASEDAGENTS_PRIVATE_KEY_HEX + BASEDAGENTS_PUBLIC_KEY_B58.';
+let _keypair; // undefined = not loaded yet
+async function getKeypair() {
+    if (_keypair !== undefined)
+        return _keypair;
+    if (process.env.BASEDAGENTS_KEYPAIR_PATH) {
+        try {
+            const raw = await readFile(process.env.BASEDAGENTS_KEYPAIR_PATH, 'utf-8');
+            const kp = JSON.parse(raw);
+            if (kp.agent_id && kp.public_key_b58 && kp.private_key_hex) {
+                _keypair = kp;
+                return _keypair;
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    const id = process.env.BASEDAGENTS_AGENT_ID;
+    const priv = process.env.BASEDAGENTS_PRIVATE_KEY_HEX;
+    const pub = process.env.BASEDAGENTS_PUBLIC_KEY_B58;
+    if (id && priv && pub) {
+        _keypair = { agent_id: id, private_key_hex: priv, public_key_b58: pub };
+        return _keypair;
+    }
+    _keypair = null;
+    return null;
+}
+function sha256hex(data) {
+    return createHash('sha256').update(data).digest('hex');
+}
+// Base58 alphabet (Bitcoin)
+const B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+function base58Decode(str) {
+    let num = 0n;
+    for (const c of str) {
+        const idx = B58.indexOf(c);
+        if (idx === -1)
+            throw new Error(`Invalid base58 character: ${c}`);
+        num = num * 58n + BigInt(idx);
+    }
+    let hex = num.toString(16);
+    if (hex.length % 2)
+        hex = '0' + hex;
+    let leadingZeros = 0;
+    for (const c of str) {
+        if (c === '1')
+            leadingZeros++;
+        else
+            break;
+    }
+    const bytes = new Uint8Array(leadingZeros + hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[leadingZeros + i / 2] = parseInt(hex.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+async function signRequest(kp, method, path, body) {
+    const timestamp = String(Math.floor(Date.now() / 1000));
+    const bodyHash = sha256hex(body);
+    const message = `${method}:${path}:${timestamp}:${bodyHash}`;
+    const msgBytes = new TextEncoder().encode(message);
+    const privKey = Uint8Array.from(Buffer.from(kp.private_key_hex, 'hex'));
+    const sig = await ed.signAsync(msgBytes, privKey);
+    const base64Sig = Buffer.from(sig).toString('base64');
+    return {
+        authorization: `AgentSig ${kp.public_key_b58}:${base64Sig}`,
+        timestamp,
+    };
+}
 // ─── API helpers ────────────────────────────────────────────────────────────
 async function apiFetch(path) {
     const res = await fetch(`${API}${path}`, {
         headers: { 'User-Agent': `basedagents-mcp/${VERSION}` },
     });
     if (!res.ok) {
-        // Consume body without leaking server internals to callers
         await res.text().catch(() => { });
         throw new Error(`BasedAgents API returned ${res.status} for ${path}`);
     }
     return res.json();
 }
+async function authedFetch(method, path, body) {
+    const kp = await getKeypair();
+    if (!kp)
+        throw new Error(AUTH_HELP);
+    const bodyStr = body ? JSON.stringify(body) : '';
+    const { authorization, timestamp } = await signRequest(kp, method, path, bodyStr);
+    const headers = {
+        'User-Agent': `basedagents-mcp/${VERSION}`,
+        'Authorization': authorization,
+        'X-Timestamp': timestamp,
+    };
+    if (body)
+        headers['Content-Type'] = 'application/json';
+    const res = await fetch(`${API}${path}`, {
+        method,
+        headers,
+        ...(body ? { body: bodyStr } : {}),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`BasedAgents API returned ${res.status} for ${method} ${path}: ${text}`);
+    }
+    return res.json();
+}
 function formatAgent(a) {
     const lines = [
         `## ${a.name} (${a.agent_id})`,
@@ -212,6 +315,140 @@ server.tool('get_chain_entry', 'Look up a specific entry in the BasedAgents hash
     ].filter(Boolean);
     return { content: [{ type: 'text', text: lines.join('\n') }] };
 });
+// ─── Messaging helpers ───────────────────────────────────────────────────────
+function noAuthResult() {
+    return {
+        content: [{ type: 'text', text: `**Auth not configured.**\n\n${AUTH_HELP}` }],
+        isError: true,
+    };
+}
+function formatMessage(m) {
+    const lines = [
+        `### ${m.subject ?? '(no subject)'}`,
+        `**ID:** \`${m.id}\`  |  **Type:** ${m.type}  |  **Status:** ${m.status}`,
+        `**From:** \`${m.from_agent_id}\`  →  **To:** \`${m.to_agent_id}\``,
+        `**Date:** ${m.created_at?.slice(0, 19).replace('T', ' ')} UTC`,
+    ];
+    if (m.reply_to_message_id)
+        lines.push(`**Reply to:** \`${m.reply_to_message_id}\``);
+    lines.push('', m.body);
+    return lines.join('\n');
+}
+function formatMessageSummary(m) {
+    const status = m.status === 'pending' ? '● ' : m.status === 'delivered' ? '◉ ' : '';
+    const date = m.created_at?.slice(0, 10) ?? '';
+    return (`${status}**${m.subject ?? '(no subject)'}** — \`${m.id}\`\n` +
+        `  ${m.type}  |  ${m.status}  |  from \`${m.from_agent_id}\`  |  ${date}`);
+}
+// ── check_messages ──────────────────────────────────────────────────────────
+server.tool('check_messages', 'Check your agent inbox for received messages. Requires keypair auth.', {
+    status: z.enum(['pending', 'delivered', 'read']).optional().describe('Filter by message status'),
+    limit: z.number().int().min(1).max(50).optional().describe('Max messages to return (default 10)'),
+}, async (params) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const qs = new URLSearchParams();
+    if (params.status)
+        qs.set('status', params.status);
+    if (params.limit)
+        qs.set('limit', String(params.limit));
+    const path = `/v1/agents/${encodeURIComponent(kp.agent_id)}/messages${qs.toString() ? `?${qs}` : ''}`;
+    const data = await authedFetch('GET', path);
+    if (!data.messages.length) {
+        return { content: [{ type: 'text', text: 'No messages found.' }] };
+    }
+    const total = data.pagination?.total ?? data.messages.length;
+    const lines = [
+        `## Inbox (${total} message${total !== 1 ? 's' : ''})\n`,
+        ...data.messages.map(formatMessageSummary),
+        '',
+        'Use `read_message` with a message ID to read the full message.',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
+// ── check_sent_messages ─────────────────────────────────────────────────────
+server.tool('check_sent_messages', 'Check messages your agent has sent. Requires keypair auth.', {
+    limit: z.number().int().min(1).max(50).optional().describe('Max messages to return (default 10)'),
+}, async (params) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const qs = new URLSearchParams();
+    if (params.limit)
+        qs.set('limit', String(params.limit));
+    const path = `/v1/agents/${encodeURIComponent(kp.agent_id)}/messages/sent${qs.toString() ? `?${qs}` : ''}`;
+    const data = await authedFetch('GET', path);
+    if (!data.messages.length) {
+        return { content: [{ type: 'text', text: 'No sent messages found.' }] };
+    }
+    const total = data.pagination?.total ?? data.messages.length;
+    const lines = [
+        `## Sent Messages (${total})\n`,
+        ...data.messages.map((m) => {
+            const date = m.created_at?.slice(0, 10) ?? '';
+            return (`**${m.subject ?? '(no subject)'}** — \`${m.id}\`\n` +
+                `  ${m.type}  |  ${m.status}  |  to \`${m.to_agent_id}\`  |  ${date}`);
+        }),
+        '',
+        'Use `read_message` with a message ID for full details.',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
+// ── read_message ────────────────────────────────────────────────────────────
+server.tool('read_message', 'Read a specific message by its ID. Auto-marks the message as read if you are the recipient. Requires keypair auth.', {
+    message_id: z.string().describe('The message ID, e.g. msg_abc123'),
+}, async ({ message_id }) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const path = `/v1/messages/${encodeURIComponent(message_id)}`;
+    const data = await authedFetch('GET', path);
+    return { content: [{ type: 'text', text: formatMessage(data) }] };
+});
+// ── send_message ────────────────────────────────────────────────────────────
+server.tool('send_message', 'Send a message to another agent. Requires keypair auth.', {
+    to_agent_id: z.string().describe('The recipient agent ID, e.g. ag_7Xk9mP2qR8nK4vL3'),
+    type: z.enum(['message', 'task_request']).describe('Message type'),
+    subject: z.string().describe('Message subject line'),
+    body: z.string().describe('Message body text'),
+}, async ({ to_agent_id, type, subject, body }) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const path = `/v1/agents/${encodeURIComponent(to_agent_id)}/messages`;
+    const data = await authedFetch('POST', path, { type, subject, body });
+    const lines = [
+        `Message sent successfully.`,
+        '',
+        `**ID:** \`${data.id}\``,
+        `**To:** \`${to_agent_id}\``,
+        `**Subject:** ${subject}`,
+        `**Status:** ${data.status ?? 'pending'}`,
+    ];
+    if (data.webhook_delivered)
+        lines.push(`**Webhook:** delivered`);
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
+// ── reply_message ───────────────────────────────────────────────────────────
+server.tool('reply_message', 'Reply to a received message. Only the original recipient can reply. Requires keypair auth.', {
+    message_id: z.string().describe('The message ID to reply to'),
+    body: z.string().describe('Reply body text'),
+}, async ({ message_id, body }) => {
+    const kp = await getKeypair();
+    if (!kp)
+        return noAuthResult();
+    const path = `/v1/messages/${encodeURIComponent(message_id)}/reply`;
+    const data = await authedFetch('POST', path, { body });
+    const lines = [
+        `Reply sent successfully.`,
+        '',
+        `**Reply ID:** \`${data.id}\``,
+        `**In reply to:** \`${message_id}\``,
+        `**Status:** ${data.status ?? 'pending'}`,
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+});
 // ─── Start ──────────────────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@basedagents/mcp",
-  "version": "0.1.1",
-  "description": "MCP server for the BasedAgents agent registry — search agents, get profiles, check reputation",
+  "version": "0.2.0",
+  "mcpName": "io.github.maxfain/basedagents",
+  "description": "MCP server for the BasedAgents identity & reputation network \u2014 search agents, get profiles, check reputation",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,7 +24,6 @@
     "mcp",
     "model-context-protocol",
     "ai-agents",
-    "agent-registry",
     "basedagents",
     "identity",
     "reputation"
@@ -40,7 +40,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1"
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@noble/ed25519": "^2.0.0"
   },
   "devDependencies": {
     "tsx": "^4.0.0",