@agentdomain/mcp-server 0.3.0 → 0.4.1

package/README.md

@@ -12,21 +12,26 @@ Lets any MCP-compatible LLM client (Claude Desktop, ChatGPT desktop apps, custom
 - `lookup_agent` - find an agent by wallet
 - `search_agents` - search the public registry
 - `send_agent_email` - send an email from an agent's address
+- `send_agent_email_batch` - queue up to 100 email objects in one API request
 - `list_agent_email` - read agent inbox/outbox messages
+- `delete_agent_email` - permanently delete one inbox/outbox message
+- `get_agent_email_usage` - inspect combined monthly sent and received usage
+- `configure_email_webhook` - configure a signed inbound email webhook
 - `update_primary_email` - change the included primary email username
-- `create_email_alias` - create a Pro/Enterprise receive-and-send email alias
+- `create_email_alias` - create a Starter/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
+- `create_dns_record` - create a user-managed record; apex routing records activate external hosting
 - `update_dns_record` - update a user-managed DNS record
 - `delete_dns_record` - delete a user-managed DNS record
-- `reconfigure_ssl` - rebuild Cloudflare SaaS SSL and DNS validation records
+- `reconfigure_ssl` - rebuild Cloudflare SaaS SSL when AgentDomain-managed hosting is active
 - `fund_renewal_vault` - top up an agent's renewal vault
 - `withdraw_renewal_vault` - build an owner-signed vault withdrawal transaction
 - `get_renewal_status` - check renewal date, amount, vault balance, and auto-renew state
 - `enable_auto_renew` - enable on-chain auto-renew with the AgentID NFT owner wallet
-- `get_service_plan` - inspect per-agent Included/Pro/Enterprise limits
-- `purchase_service_plan` - upgrade to Pro or Enterprise with x402 USDC
+- `get_service_plan` - inspect per-agent Included/Starter/Pro/Enterprise limits
+- `purchase_service_plan` - upgrade to Starter, Pro, or Enterprise with x402 USDC
+- `schedule_service_plan_renewal` - choose the exact next-renewal plan and Enterprise tier
 
 ## Install
 
@@ -70,7 +75,7 @@ Optional onchain services charge only when enabled:
 - `registerEns: false` skips ENS and ENS 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.
+- `premiumPlan: "included" | "starter" | "pro" | "enterprise"` selects the per-agent plan at registration.
 
 Use `quote_registration` first so the agent sees `platformFeeUsdc`, included
 email/SSL metadata, optional component costs, and `totalUsdc` before it signs
@@ -89,4 +94,5 @@ its own allowed endpoints, but it cannot sign x402 paid purchases by itself.
 
 ## License
 
-Apache-2.0. See the repository [LICENSE](../../LICENSE).
+Public package releases are licensed under Apache-2.0. Private AgentDomain
+platform code is not included in this package.

package/dist/index.js

@@ -53,7 +53,7 @@ function getClient() {
     }
     return new AgentDomain(config);
 }
-const server = new Server({ name: 'agentdomain-mcp', version: '0.3.0' }, { capabilities: { tools: {} } });
+const server = new Server({ name: 'agentdomain-mcp', version: '0.2.1' }, { capabilities: { tools: {} } });
 // ----------------------------------------------------------------------
 // TOOL DEFINITIONS
 // ----------------------------------------------------------------------
@@ -238,9 +238,58 @@ const TOOLS = [
             required: ['agentId', 'username'],
         },
     },
+    {
+        name: 'send_agent_email_batch',
+        description: 'Queue up to 100 emails in one request; each recipient counts toward monthly usage.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                messages: {
+                    type: 'array',
+                    maxItems: 100,
+                    items: {
+                        type: 'object',
+                        properties: {
+                            to: { type: 'string' },
+                            subject: { type: 'string' },
+                            text: { type: 'string' },
+                            fromAddress: { type: 'string' },
+                        },
+                        required: ['to', 'subject', 'text'],
+                    },
+                },
+                idempotencyKey: { type: 'string' },
+            },
+            required: ['agentId', 'messages'],
+        },
+    },
+    {
+        name: 'get_agent_email_usage',
+        description: 'Get combined sent and received monthly quota usage and reset date.',
+        inputSchema: {
+            type: 'object',
+            properties: { agentId: { type: 'string' } },
+            required: ['agentId'],
+        },
+    },
+    {
+        name: 'configure_email_webhook',
+        description: 'Configure the signed email.received webhook for an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                url: { type: 'string' },
+                payloadMode: { type: 'string', enum: ['metadata', 'inline_text'] },
+                enabled: { type: 'boolean' },
+            },
+            required: ['agentId', 'url'],
+        },
+    },
     {
         name: 'create_email_alias',
-        description: 'Create an extra receive-and-send email alias. Requires Pro or Enterprise Premium Plan capacity.',
+        description: 'Create an extra receive-and-send email alias. Requires paid-plan alias capacity.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -274,6 +323,18 @@ const TOOLS = [
             required: ['agentId'],
         },
     },
+    {
+        name: 'delete_agent_email',
+        description: 'Permanently delete one email message from an agent inbox.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'AgentDomain agent ID (UUID)' },
+                messageId: { type: 'string', description: 'Email message ID (UUID)' },
+            },
+            required: ['agentId', 'messageId'],
+        },
+    },
     {
         name: 'list_dns_records',
         description: 'List Spaceship-backed DNS records for an agent domain.',
@@ -389,19 +450,23 @@ const TOOLS = [
     },
     {
         name: 'purchase_service_plan',
-        description: 'Upgrade one agent to a Pro or Enterprise Premium Plan with x402 USDC. Requires AGENT_PRIVATE_KEY for the owner wallet.',
+        description: 'Upgrade one agent to Starter, Pro, or Enterprise with x402 USDC. Requires AGENT_PRIVATE_KEY for the owner wallet.',
         inputSchema: {
             type: 'object',
             properties: {
                 agentId: { type: 'string' },
-                plan: { type: 'string', enum: ['pro', 'enterprise'] },
+                plan: { type: 'string', enum: ['starter', 'pro', 'enterprise'] },
+                planSku: {
+                    type: 'string',
+                    description: 'For Enterprise, e.g. enterprise-100000 through enterprise-5000000.',
+                },
             },
             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.',
+        description: 'Hide or show one agent in the public AgentDomain registry. Hiding requires an active paid Premium Plan.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -414,6 +479,22 @@ const TOOLS = [
             required: ['agentId', 'registryHidden'],
         },
     },
+    {
+        name: 'schedule_service_plan_renewal',
+        description: 'Choose the exact Premium Plan SKU to charge at the next identity renewal, including any Enterprise email tier.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                plan: { type: 'string', enum: ['included', 'starter', 'pro', 'enterprise'] },
+                planSku: {
+                    type: 'string',
+                    description: 'Exact SKU; Enterprise examples range from enterprise-100000 to enterprise-5000000.',
+                },
+            },
+            required: ['agentId', 'plan', 'planSku'],
+        },
+    },
     {
         name: 'enable_auto_renew',
         description: 'Enable on-chain auto-renew for an agent. Requires the owner wallet private key and the RenewalVault contract address.',
@@ -547,6 +628,49 @@ 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 'delete_agent_email': {
+                const a = z.object({ agentId: z.string().uuid(), messageId: z.string().uuid() }).parse(args);
+                const result = await client.deleteEmailMessage(a.agentId, a.messageId);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'send_agent_email_batch': {
+                const a = z
+                    .object({
+                    agentId: z.string(),
+                    messages: z
+                        .array(z.object({
+                        to: z.string().email(),
+                        subject: z.string(),
+                        text: z.string(),
+                        fromAddress: z.string().email().optional(),
+                    }))
+                        .max(100),
+                    idempotencyKey: z.string().optional(),
+                })
+                    .parse(args);
+                const result = await client.sendEmailBatch(a.agentId, {
+                    messages: a.messages,
+                    idempotencyKey: a.idempotencyKey,
+                });
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'get_agent_email_usage': {
+                const a = z.object({ agentId: z.string() }).parse(args);
+                const result = await client.getEmailUsage(a.agentId);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            case 'configure_email_webhook': {
+                const a = z
+                    .object({
+                    agentId: z.string(),
+                    url: z.string().url(),
+                    payloadMode: z.enum(['metadata', 'inline_text']).default('metadata'),
+                    enabled: z.boolean().default(true),
+                })
+                    .parse(args);
+                const result = await client.setEmailWebhook(a.agentId, a);
+                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);
@@ -648,7 +772,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const a = z
                     .object({
                     agentId: z.string(),
-                    plan: z.enum(['pro', 'enterprise']),
+                    plan: z.enum(['starter', 'pro', 'enterprise']),
+                    planSku: z.custom().optional(),
                 })
                     .parse(args);
                 const result = await client.purchaseServicePlan(a);
@@ -659,6 +784,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const result = await client.setRegistryVisibility(a.agentId, a.registryHidden);
                 return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
             }
+            case 'schedule_service_plan_renewal': {
+                const a = z
+                    .object({
+                    agentId: z.string().uuid(),
+                    plan: z.enum(['included', 'starter', 'pro', 'enterprise']),
+                    planSku: z.custom(),
+                })
+                    .parse(args);
+                const result = await client.scheduleServicePlanRenewal(a.agentId, {
+                    plan: a.plan,
+                    planSku: a.planSku,
+                });
+                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.3.0",
+  "version": "0.4.1",
   "description": "MCP server exposing AgentDomain registration and management tools to any LLM",
   "license": "Apache-2.0",
   "repository": "https://github.com/0xmdrakib/AgentDomain.git",
@@ -24,8 +24,8 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "viem": "^2.55.2",
     "zod": "^3.24.1",
-    "@agentdomain/sdk": "^0.3.0",
-    "@agentdomain/shared": "^0.3.0"
+    "@agentdomain/shared": "^0.4.0",
+    "@agentdomain/sdk": "^0.4.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",