@agent-pay/mcp 2.0.0

package/dist/tools/provision-compute.js

@@ -0,0 +1,251 @@
+import { z } from "zod";
+import { GatewayRequestError } from "../gateway-client.js";
+export function registerProvisionCompute(server, gateway, _wallet) {
+    server.registerTool("provision_compute", {
+        title: "Provision Compute",
+        description: "Provision cloud compute on Akash Network. Analyzes your task, gets pricing from multiple providers, pays with USDC, and deploys — all in one step. Returns deployment ID, endpoints, and SSH credentials.",
+        inputSchema: {
+            task: z
+                .string()
+                .describe("Description of what the compute will be used for (e.g. 'run a PyTorch training job', 'host a Node.js API server')"),
+            cpu: z
+                .number()
+                .min(1)
+                .max(256)
+                .optional()
+                .describe("CPU cores (1-256). If omitted, auto-detected from task."),
+            memory: z
+                .string()
+                .optional()
+                .describe('RAM size (e.g. "4GB", "16GB"). If omitted, auto-detected from task.'),
+            storage: z
+                .string()
+                .optional()
+                .describe('Storage size (e.g. "20GB", "100GB"). If omitted, auto-detected from task.'),
+            image: z
+                .string()
+                .optional()
+                .describe("Docker image to deploy. If omitted, auto-detected from task."),
+            hours: z
+                .number()
+                .min(1)
+                .max(720)
+                .optional()
+                .describe("Lease duration in hours (1-720). If omitted, auto-detected from task."),
+            maxBudget: z
+                .number()
+                .optional()
+                .describe("Maximum budget in USD. Defaults to $10."),
+            gpu: z
+                .object({
+                count: z.number().min(1).describe("Number of GPUs"),
+                model: z
+                    .string()
+                    .optional()
+                    .describe('GPU model (e.g. "nvidia-a100")'),
+            })
+                .optional()
+                .describe("GPU requirements, if any."),
+            env: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe("Environment variables to set in the container."),
+            command: z
+                .array(z.string())
+                .optional()
+                .describe("Override container command."),
+            ports: z
+                .array(z.object({
+                port: z.number().describe("Port number"),
+                protocol: z
+                    .enum(["tcp", "udp"])
+                    .default("tcp")
+                    .describe("Protocol"),
+                expose: z
+                    .boolean()
+                    .default(true)
+                    .describe("Expose to the internet"),
+            }))
+                .optional()
+                .describe("Ports to expose from the container."),
+        },
+        annotations: {
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        try {
+            const maxBudget = args.maxBudget ?? 10;
+            // Step 1: If specs are incomplete, ask the LLM to analyze the task
+            let cpu = args.cpu;
+            let memory = args.memory;
+            let storage = args.storage;
+            let image = args.image;
+            let hours = args.hours;
+            if (!cpu || !memory || !storage || !image || !hours) {
+                const analysis = await gateway.analyzeTask({
+                    task: args.task,
+                    maxBudget,
+                });
+                cpu = cpu ?? analysis.recommendedCpu;
+                memory = memory ?? analysis.recommendedRam;
+                storage = storage ?? analysis.recommendedStorage;
+                image = image ?? analysis.recommendedImage;
+                hours = hours ?? analysis.estimatedDurationHours;
+            }
+            // Step 2: Get quotes from multiple providers
+            const quoteReq = {
+                cpu,
+                memory,
+                storage,
+                image,
+                hours,
+                gpu: args.gpu,
+            };
+            const { quotes } = await gateway.getMultiQuotes(quoteReq);
+            if (quotes.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No providers returned quotes for the requested specs. Try adjusting CPU, memory, or GPU requirements.",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Step 3: Select best provider
+            const selection = await gateway.selectProvider({
+                task: args.task,
+                budget: maxBudget,
+                quotes,
+            });
+            const chosenQuoteId = selection.selectedQuoteId ?? quotes[0].quoteId;
+            const chosenQuote = quotes.find((q) => q.quoteId === chosenQuoteId) ?? quotes[0];
+            // Check if escrow is available
+            const escrowInfo = chosenQuote.escrow;
+            if (escrowInfo) {
+                // ESCROW FLOW: Return quote with deposit instructions
+                const quotedUsd = (parseInt(escrowInfo.quotedAmount) / 1_000_000).toFixed(2);
+                const depositUsd = (parseInt(escrowInfo.suggestedDeposit) / 1_000_000).toFixed(2);
+                const refundEstimate = (parseFloat(depositUsd) - parseFloat(quotedUsd)).toFixed(2);
+                const text = [
+                    `## Deployment Quote Ready`,
+                    "",
+                    `**Specs:** ${cpu} CPU, ${memory} RAM, ${storage} storage`,
+                    `**Image:** ${image}`,
+                    `**Duration:** ${hours} hours`,
+                    `**Provider:** ${chosenQuote.providerName} (${chosenQuote.region})`,
+                    "",
+                    `**Cost:** $${quotedUsd} USDC`,
+                    `**Deposit:** $${depositUsd} USDC (includes buffer)`,
+                    `**Estimated Refund:** ~$${refundEstimate} USDC`,
+                    "",
+                    `### To deploy, run this command:`,
+                    "",
+                    "```",
+                    `npx @agent-pay/mcp deposit ${chosenQuoteId}`,
+                    "```",
+                    "",
+                    "This will:",
+                    "1. Open your wallet to approve the deposit",
+                    "2. Deposit funds into the escrow contract",
+                    "3. Gateway will deploy your compute automatically",
+                    "4. You'll get any unused funds back",
+                    "",
+                    "**Your Protections:**",
+                    "- Funds held in escrow until deployment succeeds",
+                    "- Full refund if deployment fails",
+                    "- Excess funds automatically returned",
+                    "- All transactions recorded on-chain",
+                    "",
+                    `Quote expires in 5 minutes.`,
+                ].join("\n");
+                return { content: [{ type: "text", text }] };
+            }
+            // LEGACY FLOW: Direct provision (for backwards compatibility)
+            const deployment = await gateway.provision({
+                quoteId: chosenQuoteId,
+                env: args.env,
+                command: args.command,
+                ports: args.ports,
+            });
+            // Get payment info from response
+            const paymentInfo = deployment.payment || {};
+            const paymentTxHash = paymentInfo.txHash || "pending";
+            // Poll for running status (up to 90s)
+            let status = await gateway.getDeploymentStatus(deployment.deploymentId);
+            const deadline = Date.now() + 90_000;
+            while (status.status !== "running" &&
+                status.status !== "failed" &&
+                Date.now() < deadline) {
+                await sleep(3000);
+                status = await gateway.getDeploymentStatus(deployment.deploymentId);
+            }
+            const endpointLines = status.endpoints && status.endpoints.length > 0
+                ? status.endpoints
+                    .map((ep) => `  ${ep.protocol}://${ep.host}:${ep.port}`)
+                    .join("\n")
+                : "  (endpoints not yet available — check status again shortly)";
+            const text = [
+                `Deployment **${deployment.deploymentId}** is **${status.status}**.`,
+                "",
+                `Provider: ${chosenQuote.providerName} (${chosenQuote.region})`,
+                `Image: ${image}`,
+                `Specs: ${cpu} CPU, ${memory} RAM, ${storage} storage, ${hours}h`,
+                `Cost: ${chosenQuote.priceUsdc} USDC`,
+                `Payment tx: ${paymentTxHash}`,
+                "",
+                "Endpoints:",
+                endpointLines,
+                "",
+                `SSH: ssh ${deployment.credentials.sshUser}@${deployment.credentials.sshHost} -p ${deployment.credentials.sshPort}`,
+                `Access token: ${deployment.credentials.accessToken}`,
+                "",
+                `Expires: ${new Date(status.expiresAt).toISOString()}`,
+            ].join("\n");
+            return { content: [{ type: "text", text }] };
+        }
+        catch (err) {
+            if (err instanceof GatewayRequestError) {
+                // Handle payment failures with helpful message
+                if (err.status === 402) {
+                    const body = err.body;
+                    const lines = [
+                        "## Insufficient Spending Allowance",
+                        "",
+                        `This deployment costs **${body.details?.required || "unknown"}** but your current spending limit is **${body.details?.allowance || "$0.00"}**.`,
+                        "",
+                        "### To approve spending:",
+                        "",
+                        `\`\`\``,
+                        body.action || "npx @agent-pay/mcp approve 50",
+                        `\`\`\``,
+                        "",
+                        body.hint || "This will open your wallet to set a spending limit. No funds are charged until you provision compute.",
+                        "",
+                        "After approving, come back here and try again!",
+                    ];
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: `Gateway error (${err.status}): ${err.message}` }],
+                    isError: true,
+                };
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: msg }],
+                isError: true,
+            };
+        }
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=provision-compute.js.map

package/dist/tools/provision-compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision-compute.js","sourceRoot":"","sources":["../../src/tools/provision-compute.ts"],"names":[],"mappings":"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"}

package/dist/tools/stop-deployment.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GatewayClient } from "../gateway-client.js";
+export declare function registerStopDeployment(server: McpServer, gateway: GatewayClient): void;

package/dist/tools/stop-deployment.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { GatewayRequestError } from "../gateway-client.js";
+export function registerStopDeployment(server, gateway) {
+    server.registerTool("stop_deployment", {
+        title: "Stop Deployment",
+        description: "Stop a running Akash compute deployment. This closes the lease and frees the resources. Cannot be undone.",
+        inputSchema: {
+            deploymentId: z
+                .string()
+                .describe('The deployment ID to stop (e.g. "deploy_abc123")'),
+        },
+        annotations: {
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        try {
+            const result = await gateway.closeDeployment(args.deploymentId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Deployment **${result.deploymentId}** has been **stopped**. ${result.message}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof GatewayRequestError
+                ? `Gateway error (${err.status}): ${err.message}`
+                : err instanceof Error
+                    ? err.message
+                    : String(err);
+            return {
+                content: [{ type: "text", text: msg }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=stop-deployment.js.map

package/dist/tools/stop-deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-deployment.js","sourceRoot":"","sources":["../../src/tools/stop-deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,OAAsB;IAEtB,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,2GAA2G;QAC7G,WAAW,EAAE;YACX,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,kDAAkD,CAAC;SAChE;QACD,WAAW,EAAE;YACX,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAEhE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gBAAgB,MAAM,CAAC,YAAY,4BAA4B,MAAM,CAAC,OAAO,EAAE;qBACtF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GACP,GAAG,YAAY,mBAAmB;gBAChC,CAAC,CAAC,kBAAkB,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE;gBACjD,CAAC,CAAC,GAAG,YAAY,KAAK;oBACpB,CAAC,CAAC,GAAG,CAAC,OAAO;oBACb,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;gBAC/C,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,227 @@
+export interface ComputeSpecs {
+    cpu: number;
+    memory: string;
+    storage: string;
+    image: string;
+    hours: number;
+    region?: string;
+    gpu?: {
+        count: number;
+        model?: string;
+    };
+}
+export interface QuoteRequest {
+    cpu: number;
+    memory: string;
+    storage: string;
+    image: string;
+    hours: number;
+    region?: string;
+    gpu?: {
+        count: number;
+        model?: string;
+    };
+}
+export interface QuotePricing {
+    akashCostUakt: string;
+    akashCostUsd: string;
+    markupUsd: string;
+    totalUsd: string;
+    totalUsdc: string;
+}
+export interface PaymentDetails {
+    network: string;
+    token: string;
+    recipient: string;
+    amount: string;
+}
+export interface QuoteResponse {
+    quoteId: string;
+    specs: ComputeSpecs;
+    pricing: QuotePricing;
+    paymentDetails: PaymentDetails;
+    validUntil: number;
+    createdAt: number;
+}
+export interface ProviderQuote {
+    quoteId: string;
+    provider: string;
+    providerName: string;
+    region: string;
+    priceUsdc: string;
+    currency: string;
+    validUntil: number;
+    capabilities: string;
+    specs: ComputeSpecs;
+}
+export interface MultiQuoteResponse {
+    quotes: ProviderQuote[];
+}
+export interface ProvisionRequest {
+    quoteId: string;
+    paymentTx?: string;
+    image?: string;
+    provider?: string;
+    specs?: {
+        cpu?: number;
+        ram?: string;
+        memory?: string;
+        storage?: string;
+    };
+    env?: Record<string, string>;
+    command?: string[];
+    ports?: Array<{
+        port: number;
+        protocol: "tcp" | "udp";
+        expose: boolean;
+    }>;
+}
+export interface ProvisionResponse {
+    deploymentId: string;
+    provider: string;
+    providerName: string;
+    host: string;
+    ports: {
+        http: number;
+        https: number;
+        ssh: number;
+    };
+    status: string;
+    expiresAt: number;
+    credentials: {
+        sshHost: string;
+        sshPort: number;
+        sshUser: string;
+        accessToken: string;
+    };
+    message: string;
+}
+export interface AkashInfo {
+    dseq?: string;
+    gseq?: number;
+    oseq?: number;
+    provider?: string;
+    leaseId?: string;
+}
+export interface DeploymentEndpoint {
+    host: string;
+    port: number;
+    protocol: string;
+}
+export interface DeploymentStatus {
+    deploymentId: string;
+    status: "pending" | "deploying" | "running" | "stopped" | "failed";
+    quoteId: string;
+    paymentTxHash?: string;
+    akash: AkashInfo;
+    endpoints?: DeploymentEndpoint[];
+    specs: ComputeSpecs;
+    expiresAt: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ListDeploymentsResponse {
+    deployments: DeploymentStatus[];
+    total: number;
+}
+export interface CloseDeploymentResponse {
+    deploymentId: string;
+    status: "stopped";
+    message: string;
+}
+export interface AnalyzeRequest {
+    task: string;
+    maxBudget?: number;
+}
+export interface AnalyzeResponse {
+    recommendedCpu: number;
+    recommendedRam: string;
+    recommendedStorage: string;
+    recommendedImage: string;
+    estimatedDurationHours: number;
+    reasoning: string;
+    confidence: "high" | "medium" | "low";
+}
+export interface SelectProviderRequest {
+    task: string;
+    budget: number | string;
+    quotes: ProviderQuote[];
+}
+export interface SelectProviderResponse {
+    selectedProvider: string | null;
+    selectedQuoteId: string | null;
+    selectionReason: string;
+    confidence: "high" | "medium" | "low";
+}
+export interface PayRequest {
+    quoteId?: string;
+    amount?: string;
+    recipient?: string;
+    memo?: string;
+    currency?: string;
+    network?: string;
+}
+export interface PayResponse {
+    txHash: string;
+    amount: string;
+    recipient: string;
+    memo: string;
+    currency: string;
+    network: string;
+    timestamp: number;
+    status: "confirmed";
+    blockNumber: number;
+}
+export interface GatewayError {
+    error: string;
+    details?: unknown[];
+    reason?: string;
+    required?: {
+        amount: string;
+        token: string;
+        recipient: string;
+        network: string;
+    };
+    setup?: string;
+    action?: string;
+}
+export interface AuthRegisterResponse {
+    token: string;
+    walletAddress: string;
+    balance: {
+        usdc: string;
+        raw: string;
+    };
+    allowance: {
+        usdc: string;
+        raw: string;
+    };
+    message: string;
+}
+export interface AuthVerifyResponse {
+    valid: boolean;
+    walletAddress?: string;
+    error?: string;
+    balance?: {
+        usdc: string;
+        raw: string;
+    };
+    allowance?: {
+        usdc: string;
+        raw: string;
+    };
+}
+export interface AuthInfoResponse {
+    walletAddress: string;
+    balance: {
+        usdc: string;
+        raw: string;
+    };
+    allowance: {
+        usdc: string;
+        raw: string;
+        sufficient: boolean;
+    };
+    network: string;
+    gatewayAddress: string;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Gateway API Types ──
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,0BAA0B"}

package/dist/wallet.d.ts

@@ -0,0 +1,27 @@
+import { type Address, type Hash, type PublicClient, type WalletClient } from "viem";
+export interface TransferResult {
+    txHash: Hash;
+}
+export declare class UsdcWallet {
+    readonly address: Address;
+    readonly network: string;
+    private publicClient;
+    private walletClient;
+    private usdcAddress;
+    constructor(publicClient: PublicClient, walletClient: WalletClient, address: Address, usdcAddress: Address, network: string);
+    /**
+     * Transfer USDC to a recipient.
+     * @param to - recipient address
+     * @param amount - raw amount in USDC smallest unit (6 decimals, e.g. "32200" = 0.0322 USDC)
+     */
+    transferUsdc(to: Address, amount: bigint): Promise<TransferResult>;
+    /**
+     * Get USDC balance formatted as a human-readable string (e.g. "12.50").
+     */
+    getBalance(): Promise<string>;
+}
+/**
+ * Create a USDC wallet from environment variables.
+ * Returns null if AGENT_PAY_WALLET_KEY is not set (simulated mode).
+ */
+export declare function createWallet(): UsdcWallet | null;