@agentdomain/mcp-server 0.1.1 → 0.2.0

package/README.md

@@ -13,6 +13,9 @@ Lets any MCP-compatible LLM client (Claude Desktop, ChatGPT desktop apps, custom
 - `search_agents` - search the public registry
 - `send_agent_email` - send an email from an agent's address
 - `list_agent_email` - read agent inbox/outbox messages
+- `update_primary_email` - change the included primary email username
+- `create_email_alias` - create a Pro/Enterprise receive-and-send email alias
+- `delete_email_alias` - delete an active email alias
 - `list_dns_records` - list DNS records for an agent domain
 - `create_dns_record` - create a user-managed DNS record
 - `update_dns_record` - update a user-managed DNS record
@@ -57,25 +60,32 @@ from any wallet, but the RenewalVault contract only accepts auto-renew changes f
 
 ## Pricing flags
 
-Domain, DNS, service fee, and SSL certification are mandatory. SSL certification
-costs `$1.20` per year and is included in registration and exact renewal status
-quotes.
+Registration pricing includes the live domain price plus the annual AgentDomain
+platform fee. Email setup, SSL certification, DNS orchestration, and AgentID NFT
+mint/orchestration are included in that platform fee.
 
-Optional services charge only when enabled:
+Optional onchain services charge only when enabled:
 
 - `registerBasename: false` skips Basename and Basename cost.
 - `registerEns: false` skips ENS and ENS cost.
-- `emailEnabled: false` skips email and email cost.
+- `emailEnabled` is still accepted for old clients but is deprecated and ignored.
+- `emailUsername` customizes the primary inbox local-part; omit it for `agent@domain`.
+- `premiumPlan: "included" | "pro" | "enterprise"` selects the per-agent plan at registration.
 
-Use `quote_registration` first so the agent sees `sslCertificationFeeUsdc`,
-optional component costs, and `totalUsdc` before it signs the x402 payment.
+Use `quote_registration` first so the agent sees `platformFeeUsdc`, included
+email/SSL metadata, optional component costs, and `totalUsdc` before it signs
+the x402 payment.
 
 For renewals, `get_renewal_status` returns the exact next renewal amount and the
 shortfall to fund before the keeper can reserve and complete the renewal.
 
-For service plans, `purchase_service_plan` accepts `prepayPeriods`. Extra
-periods become prepaid service-plan credit; service-plan auto-renew consumes
-that credit instead of pretending a reusable x402 signature exists.
+For Premium Plans, `purchase_service_plan` upgrades coverage through the
+agent's current expiry. Future Premium Plan renewal is charged together with the
+identity renewal quote in RenewalVault.
+
+Autonomous Premium Plan purchase requires `AGENT_PRIVATE_KEY` for the owner or a
+delegated wallet on Base with enough USDC. An agent-scoped API key can operate
+its own allowed endpoints, but it cannot sign x402 paid purchases by itself.
 
 ## License
 

package/dist/index.js

@@ -26,7 +26,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
 import { AgentDomain } from '@agentdomain/sdk';
-import { AGENTDOMAIN_API_BASE_URL, SUPPORTED_FRAMEWORKS, SUPPORTED_TLDS, } from '@agentdomain/shared/constants';
+import { AGENTDOMAIN_API_BASE_URL, SERVICE_PLAN_KEYS, SUPPORTED_FRAMEWORKS, SUPPORTED_TLDS, } from '@agentdomain/shared/constants';
 import { createPublicClient, createWalletClient, http } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { base, baseSepolia } from 'viem/chains';
@@ -53,7 +53,7 @@ function getClient() {
     }
     return new AgentDomain(config);
 }
-const server = new Server({ name: 'agentdomain-mcp', version: '0.1.1' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'agentdomain-mcp', version: '0.2.0' }, { capabilities: { tools: {} } });
 // ----------------------------------------------------------------------
 // TOOL DEFINITIONS
 // ----------------------------------------------------------------------
@@ -76,7 +76,7 @@ const TOOLS = [
     },
     {
         name: 'quote_registration',
-        description: 'Get a price quote for registering an agent identity bundle. Domain, DNS, SSL certification, and service fee are mandatory. Basename, ENS, and email are optional.',
+        description: 'Get a price quote for registering an agent identity bundle. Domain, DNS, email, SSL, AgentID NFT orchestration, and platform fee are included by default. Basename and ENS are optional.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -94,18 +94,28 @@ const TOOLS = [
                 },
                 emailEnabled: {
                     type: 'boolean',
-                    description: 'Set true to add an email inbox; false skips email cost.',
-                    default: false,
+                    description: 'Deprecated compatibility flag. Email is now always included.',
+                    default: true,
+                },
+                emailUsername: {
+                    type: 'string',
+                    description: 'Primary email username. Defaults to agent, producing agent@domain.',
+                    default: 'agent',
+                },
+                premiumPlan: {
+                    type: 'string',
+                    enum: SERVICE_PLAN_KEYS,
+                    default: 'included',
+                    description: 'Premium Plan to buy with registration.',
                 },
                 years: { type: 'integer', default: 1, minimum: 1, maximum: 10 },
-                discountCode: { type: 'string', description: 'Optional service-fee discount code' },
             },
             required: ['preferredName'],
         },
     },
     {
         name: 'register_agent_identity',
-        description: 'Register a complete agent identity bundle. Domain, DNS, SSL certification, and service fee are mandatory. Set optional booleans false to skip Basename, ENS, or email. Pays in USDC on Base. Requires AGENT_PRIVATE_KEY env var.',
+        description: 'Register a complete agent identity bundle. Domain, DNS, email, SSL, AgentID NFT orchestration, and platform fee are included by default. Basename and ENS are optional. Pays in USDC on Base. Requires AGENT_PRIVATE_KEY env var.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -129,10 +139,20 @@ const TOOLS = [
                 },
                 emailEnabled: {
                     type: 'boolean',
-                    description: 'Set true to add an email inbox; false skips email cost.',
-                    default: false,
+                    description: 'Deprecated compatibility flag. Email is now always included.',
+                    default: true,
+                },
+                emailUsername: {
+                    type: 'string',
+                    description: 'Primary email username. Defaults to agent, producing agent@domain.',
+                    default: 'agent',
+                },
+                premiumPlan: {
+                    type: 'string',
+                    enum: SERVICE_PLAN_KEYS,
+                    default: 'included',
+                    description: 'Premium Plan to buy with registration.',
                 },
-                discountCode: { type: 'string', description: 'Optional service-fee discount code' },
                 years: { type: 'integer', default: 1, minimum: 1, maximum: 10 },
                 autoRenew: { type: 'boolean', default: false },
                 dnsTarget: { type: 'string', description: 'URL or IP to point the domain at' },
@@ -161,6 +181,17 @@ const TOOLS = [
             required: ['wallet'],
         },
     },
+    {
+        name: 'get_agent',
+        description: 'Get one agent identity by AgentDomain agent ID. Works with an agent-scoped API key.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'AgentDomain agent ID (UUID)' },
+            },
+            required: ['agentId'],
+        },
+    },
     {
         name: 'search_agents',
         description: 'Search the public agent registry by name, capability, or framework.',
@@ -187,10 +218,50 @@ const TOOLS = [
                 to: { type: 'string' },
                 subject: { type: 'string' },
                 text: { type: 'string' },
+                fromAddress: {
+                    type: 'string',
+                    description: 'Optional primary or active alias address to send from.',
+                },
             },
             required: ['agentId', 'to', 'subject'],
         },
     },
+    {
+        name: 'update_primary_email',
+        description: 'Change the primary email username for an agent. The old primary address stops receiving new mail.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'AgentDomain agent ID (UUID)' },
+                username: { type: 'string', description: 'New primary local-part, e.g. agent or support' },
+            },
+            required: ['agentId', 'username'],
+        },
+    },
+    {
+        name: 'create_email_alias',
+        description: 'Create an extra receive-and-send email alias. Requires Pro or Enterprise Premium Plan capacity.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'AgentDomain agent ID (UUID)' },
+                username: { type: 'string', description: 'Alias local-part, e.g. billing' },
+            },
+            required: ['agentId', 'username'],
+        },
+    },
+    {
+        name: 'delete_email_alias',
+        description: 'Delete an active email alias from an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'AgentDomain agent ID (UUID)' },
+                emailAddress: { type: 'string', description: 'Full alias address to delete' },
+            },
+            required: ['agentId', 'emailAddress'],
+        },
+    },
     {
         name: 'list_agent_email',
         description: 'List received/sent text-only email messages for an email-enabled agent, including extracted verification codes.',
@@ -307,7 +378,7 @@ const TOOLS = [
     },
     {
         name: 'get_service_plan',
-        description: 'Get the current AgentDomain service plan, entitlement limits, billing interval, and recent purchases for one agent.',
+        description: 'Get the current AgentDomain Premium Plan, entitlement limits, billing interval, registry privacy, and recent purchases for one agent.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -318,23 +389,29 @@ const TOOLS = [
     },
     {
         name: 'purchase_service_plan',
-        description: 'Upgrade one agent to Pro or Enterprise with x402 USDC. Requires AGENT_PRIVATE_KEY for the owner wallet.',
+        description: 'Upgrade one agent to a Pro or Enterprise Premium Plan with x402 USDC. Requires AGENT_PRIVATE_KEY for the owner wallet.',
         inputSchema: {
             type: 'object',
             properties: {
                 agentId: { type: 'string' },
                 plan: { type: 'string', enum: ['pro', 'enterprise'] },
-                interval: { type: 'string', enum: ['monthly', 'yearly'] },
-                autoRenew: { type: 'boolean', default: false },
-                prepayPeriods: {
-                    type: 'number',
-                    minimum: 1,
-                    maximum: 12,
-                    default: 1,
-                    description: 'Number of periods to prepay. Extra periods become auto-renew credit.',
+            },
+            required: ['agentId', 'plan'],
+        },
+    },
+    {
+        name: 'set_registry_visibility',
+        description: 'Hide or show one agent in the public AgentDomain registry. Hiding requires an active Pro or Enterprise Premium Plan.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                registryHidden: {
+                    type: 'boolean',
+                    description: 'true hides the agent from public registry/search; false makes it public',
                 },
             },
-            required: ['agentId', 'plan', 'interval'],
+            required: ['agentId', 'registryHidden'],
         },
     },
     {
@@ -374,9 +451,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     tld: z.enum(SUPPORTED_TLDS).default('xyz'),
                     registerBasename: z.boolean().default(true),
                     registerEns: z.boolean().default(false),
-                    emailEnabled: z.boolean().default(false),
+                    emailEnabled: z.boolean().default(true),
+                    emailUsername: z.string().optional(),
+                    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
                     years: z.number().int().min(1).max(10).default(1),
-                    discountCode: z.string().max(50).optional(),
                 })
                     .parse(args);
                 const result = await client.quote(a);
@@ -406,10 +484,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         .string()
                         .regex(/^0x[a-fA-F0-9]{40}$/)
                         .optional(),
-                    emailEnabled: z.boolean().default(false),
+                    emailEnabled: z.boolean().default(true),
+                    emailUsername: z.string().optional(),
+                    premiumPlan: z.enum(SERVICE_PLAN_KEYS).default('included'),
                     years: z.number().int().min(1).max(10).default(1),
                     autoRenew: z.boolean().default(false),
-                    discountCode: z.string().max(50).optional(),
                     dnsTarget: z.string().optional(),
                     metadata: z.record(z.any()).optional(),
                 })
@@ -428,6 +507,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const result = await client.getAgentsByWallet(a.wallet);
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
+            case 'get_agent': {
+                const a = z.object({ agentId: z.string() }).parse(args);
+                const result = await client.getAgentById(a.agentId);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
             case 'search_agents': {
                 const a = z
                     .object({
@@ -447,10 +531,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     to: z.string(),
                     subject: z.string(),
                     text: z.string(),
+                    fromAddress: z.string().email().optional(),
                 })
                     .parse(args);
                 const result = await client.sendEmail(a.agentId, {
                     to: a.to,
+                    fromAddress: a.fromAddress,
                     subject: a.subject,
                     text: a.text,
                 });
@@ -461,6 +547,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const result = await client.listEmail(a.agentId, { limit: a.limit });
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
+            case 'update_primary_email': {
+                const a = z.object({ agentId: z.string(), username: z.string() }).parse(args);
+                const result = await client.updatePrimaryEmail(a.agentId, a.username);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'create_email_alias': {
+                const a = z.object({ agentId: z.string(), username: z.string() }).parse(args);
+                const result = await client.createEmailAlias(a.agentId, a.username);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'delete_email_alias': {
+                const a = z.object({ agentId: z.string(), emailAddress: z.string().email() }).parse(args);
+                const result = await client.deleteEmailAlias(a.agentId, a.emailAddress);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
             case 'list_dns_records': {
                 const a = z.object({ agentId: z.string() }).parse(args);
                 const result = await client.listDnsRecords(a.agentId);
@@ -539,7 +640,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         content: [
                             {
                                 type: 'text',
-                                text: 'AGENT_PRIVATE_KEY env var is required to purchase a service plan.',
+                                text: 'AGENT_PRIVATE_KEY env var is required to purchase a Premium Plan.',
                             },
                         ],
                     };
@@ -548,14 +649,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     .object({
                     agentId: z.string(),
                     plan: z.enum(['pro', 'enterprise']),
-                    interval: z.enum(['monthly', 'yearly']),
-                    autoRenew: z.boolean().default(false),
-                    prepayPeriods: z.number().int().min(1).max(12).default(1),
                 })
                     .parse(args);
                 const result = await client.purchaseServicePlan(a);
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
+            case 'set_registry_visibility': {
+                const a = z.object({ agentId: z.string(), registryHidden: z.boolean() }).parse(args);
+                const result = await client.setRegistryVisibility(a.agentId, a.registryHidden);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
             case 'enable_auto_renew': {
                 if (!AGENT_PRIVATE_KEY) {
                     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdomain/mcp-server",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP server exposing AgentDomain registration and management tools to any LLM",
   "license": "MIT",
   "type": "module",
@@ -19,14 +19,14 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
-    "viem": "^2.21.55",
+    "viem": "^2.55.2",
     "zod": "^3.24.1",
-    "@agentdomain/sdk": "^0.1.1",
-    "@agentdomain/shared": "^0.1.1"
+    "@agentdomain/sdk": "^0.2.0",
+    "@agentdomain/shared": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
-    "tsx": "^4.19.2",
+    "tsx": "^4.23.1",
     "typescript": "^5.7.2"
   },
   "scripts": {