@aifinpay/mcp 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,96 @@
+# @aifinpay/mcp
+
+MCP server exposing AiFinPay's autonomous x402 payment loop as
+agent-callable tools. Drop it into Claude Desktop, MCP Inspector, or any
+MCP-aware agent runtime — your agent can now buy services autonomously.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `payable_fetch(url, opts?)` | Fetch any URL. On 402, auto-detect facilitator, sign, retry. |
+| `agent_address()` | Return the agent's Solana base58 pubkey (so you know where to fund). |
+| `agent_quote(url)` | Inspect a 402 challenge without paying. Shows the merchant's quoted amount + facilitator flavor. |
+
+## Install
+
+```bash
+# Globally — usable as `npx @aifinpay/mcp` from any client config
+npm install -g @aifinpay/mcp
+```
+
+## Use with Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "aifinpay": {
+      "command": "npx",
+      "args": ["@aifinpay/mcp"],
+      "env": {
+        "AIFINPAY_AGENT_SECRET": "<base58 secret — see below>",
+        "AIFINPAY_MAX_USD": "0.50"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Now Claude can call `payable_fetch`, `agent_address`,
+and `agent_quote` like any other tool.
+
+## First run — generating an agent
+
+If `AIFINPAY_AGENT_SECRET` is not set, the server generates an ephemeral
+keypair and **prints it to stderr** at startup:
+
+```
+[warn] no AIFINPAY_AGENT_SECRET set — generated EPHEMERAL agent.
+  address: 9HucVaL5yinJ4MfBKCFnz5QJBGwK33bfSQKw15pSe3Ch
+  secret:  2vfeWAYfkpTNGSgDpBonzmjkckrTKa5GTnhhztY141YcSKYrqCvtojVukQAQiJbbRLgdcfEdyqHbRMsUft6Pb7nD
+  >> Save this secret to AIFINPAY_AGENT_SECRET to keep the agent across restarts.
+```
+
+Save the secret to `AIFINPAY_AGENT_SECRET` in your client config so the
+agent identity (and any funded Seat) persists across restarts.
+
+## Environment variables
+
+| Var | Default | Purpose |
+|---|---|---|
+| `AIFINPAY_AGENT_SECRET` | — | Base58 secret. If absent → ephemeral agent printed to stderr. |
+| `AIFINPAY_BASE_URL` | `https://aifinpay.company` | Backend URL for nonce + funding probes. |
+| `AIFINPAY_TIMEOUT_MS` | `30000` | Request timeout. |
+| `AIFINPAY_MAX_USD` | — | Hard cap per single payment. Strongly recommended. |
+
+## Programmatic use
+
+```ts
+import { createServer, loadConfigFromEnv } from "@aifinpay/mcp";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const { server } = createServer({
+  ...loadConfigFromEnv(),
+  agentSecretB58: "your-secret-here",
+  maxAmountUsd: 0.10,
+});
+await server.connect(new StdioServerTransport());
+```
+
+## How `payable_fetch` works
+
+1. Sends the request unauthenticated.
+2. On `402`, the underlying [`@aifinpay/agent`](../node) SDK detects the
+   facilitator flavor (AiFinPay native, Coinbase x402, …).
+3. Signs a payment payload and retries.
+4. Returns `{ status, ok, headers, body }` to the agent.
+
+The flow is identical to calling `agent.pay(url)` directly — this
+package just wraps it as an MCP tool surface so LLM agents can call it
+without writing payment code.
+
+## License
+
+MIT.

package/bin/aifinpay-mcp.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * stdio entry point — run `npx @aifinpay/mcp` to start the MCP server
+ * in stdio mode. Compatible with Claude Desktop, MCP Inspector, and any
+ * MCP-aware agent runtime.
+ *
+ * Configure via env:
+ *   AIFINPAY_AGENT_SECRET   base58 secret (load existing identity)
+ *   AIFINPAY_BASE_URL       default https://aifinpay.company
+ *   AIFINPAY_TIMEOUT_MS     default 30000
+ *   AIFINPAY_MAX_USD        hard cap per single payment (no default)
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer, loadConfigFromEnv } from "../dist/index.js";
+
+const { server } = createServer(loadConfigFromEnv());
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+/** Runtime configuration loaded from env. */
+export interface McpConfig {
+    /** Base58 secret to load the agent identity. If absent, a fresh keypair is
+     *  generated AND printed to stderr at startup with a "save this!" warning. */
+    agentSecretB58?: string;
+    /** Custom AiFinPay backend URL. Defaults to production. */
+    baseUrl?: string;
+    /** Request timeout in ms. */
+    timeoutMs?: number;
+    /** Hard cap on a single payment to prevent runaway agents. */
+    maxAmountUsd?: number;
+    /** Optional log destination (defaults to stderr). */
+    logFn?: (level: "info" | "warn" | "error", msg: string) => void;
+}
+export declare function loadConfigFromEnv(): McpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB;kFAC8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qDAAqD;IACrD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAW7C"}

package/dist/config.js

@@ -0,0 +1,13 @@
+export function loadConfigFromEnv() {
+    return {
+        agentSecretB58: process.env.AIFINPAY_AGENT_SECRET || undefined,
+        baseUrl: process.env.AIFINPAY_BASE_URL || undefined,
+        timeoutMs: process.env.AIFINPAY_TIMEOUT_MS
+            ? Number(process.env.AIFINPAY_TIMEOUT_MS)
+            : undefined,
+        maxAmountUsd: process.env.AIFINPAY_MAX_USD
+            ? Number(process.env.AIFINPAY_MAX_USD)
+            : undefined,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,SAAS;QAC9D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,SAAS;QACnD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACzC,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;YACxC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACtC,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @aifinpay/mcp — MCP server exposing AiFinPay's autonomous x402 payment
+ * loop as agent-callable tools.
+ *
+ * Tools:
+ *   - payable_fetch(url, opts?) — fetch any URL, auto-pay on 402
+ *   - agent_address()           — show pubkey to fund
+ *   - agent_quote(url)          — inspect 402 cost before paying
+ *
+ * Quick start (stdio transport for Claude Desktop / MCP-aware runtimes):
+ *
+ *   $ npx @aifinpay/mcp
+ *
+ * Or programmatically:
+ *
+ *   import { createServer } from "@aifinpay/mcp";
+ *   import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+ *
+ *   const { server } = createServer({ agentSecretB58: process.env.SECRET });
+ *   await server.connect(new StdioServerTransport());
+ */
+export { createServer } from "./server.js";
+export type { ToolContext } from "./server.js";
+export type { McpConfig } from "./config.js";
+export { loadConfigFromEnv } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @aifinpay/mcp — MCP server exposing AiFinPay's autonomous x402 payment
+ * loop as agent-callable tools.
+ *
+ * Tools:
+ *   - payable_fetch(url, opts?) — fetch any URL, auto-pay on 402
+ *   - agent_address()           — show pubkey to fund
+ *   - agent_quote(url)          — inspect 402 cost before paying
+ *
+ * Quick start (stdio transport for Claude Desktop / MCP-aware runtimes):
+ *
+ *   $ npx @aifinpay/mcp
+ *
+ * Or programmatically:
+ *
+ *   import { createServer } from "@aifinpay/mcp";
+ *   import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+ *
+ *   const { server } = createServer({ agentSecretB58: process.env.SECRET });
+ *   await server.connect(new StdioServerTransport());
+ */
+export { createServer } from "./server.js";
+export { loadConfigFromEnv } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,52 @@
+import { Agent } from "@aifinpay/agent";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { McpConfig } from "./config.js";
+/**
+ * Build an MCP server that wraps the AiFinPay agent SDK as MCP tools.
+ *
+ * Returned server is unstarted — caller wires up a transport (stdio, SSE,
+ * etc.) via the official `@modelcontextprotocol/sdk` package.
+ */
+export declare function createServer(config?: McpConfig): {
+    server: Server<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+                "io.modelcontextprotocol/related-task"?: {
+                    taskId: string;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
+    agent: Agent;
+};
+export interface ToolContext {
+    agent: Agent;
+    config: McpConfig;
+    log: (level: "info" | "warn" | "error", msg: string) => void;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,SAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ElD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D"}

package/dist/server.js

@@ -0,0 +1,84 @@
+import { Agent } from "@aifinpay/agent";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { payableFetchTool, runPayableFetch } from "./tools/payable-fetch.js";
+import { agentAddressTool, runAgentAddress } from "./tools/agent-address.js";
+import { agentQuoteTool, runAgentQuote } from "./tools/agent-quote.js";
+import { payWithSplitTool, runPayWithSplit, quoteSplitTool, runQuoteSplit, } from "./tools/pay-with-split.js";
+/**
+ * Build an MCP server that wraps the AiFinPay agent SDK as MCP tools.
+ *
+ * Returned server is unstarted — caller wires up a transport (stdio, SSE,
+ * etc.) via the official `@modelcontextprotocol/sdk` package.
+ */
+export function createServer(config = {}) {
+    const log = config.logFn ?? defaultLog;
+    // Agent identity: load from env secret if provided, else generate one
+    // and print to stderr so the human knows what to fund.
+    const agent = config.agentSecretB58
+        ? Agent.fromSecretB58(config.agentSecretB58, {
+            baseUrl: config.baseUrl,
+            timeoutMs: config.timeoutMs,
+        })
+        : (() => {
+            const a = Agent.new({
+                baseUrl: config.baseUrl,
+                timeoutMs: config.timeoutMs,
+            });
+            log("warn", `[aifinpay-mcp] no AIFINPAY_AGENT_SECRET set — generated EPHEMERAL agent.\n` +
+                `  address: ${a.address}\n` +
+                `  secret:  ${a.secretB58}\n` +
+                `  >> Save this secret to AIFINPAY_AGENT_SECRET to keep the agent across restarts.`);
+            return a;
+        })();
+    log("info", `[aifinpay-mcp] agent address: ${agent.address}`);
+    const server = new Server({
+        name: "@aifinpay/mcp",
+        version: "0.1.0-alpha.2",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                payableFetchTool(),
+                agentAddressTool(),
+                agentQuoteTool(),
+                payWithSplitTool(),
+                quoteSplitTool(),
+            ],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const ctx = { agent, config, log };
+        switch (name) {
+            case "payable_fetch":
+                return runPayableFetch(ctx, args ?? {});
+            case "agent_address":
+                return runAgentAddress(ctx, args ?? {});
+            case "agent_quote":
+                return runAgentQuote(ctx, args ?? {});
+            case "pay_with_split":
+                return runPayWithSplit(ctx, args ?? {});
+            case "quote_split":
+                return runQuoteSplit(ctx, args ?? {});
+            default:
+                return {
+                    isError: true,
+                    content: [
+                        { type: "text", text: `unknown tool: ${name}` },
+                    ],
+                };
+        }
+    });
+    return { server, agent };
+}
+function defaultLog(level, msg) {
+    // MCP stdio servers MUST NOT write to stdout — the transport owns it.
+    // stderr is safe.
+    process.stderr.write(`[${level}] ${msg}\n`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/agent-address.d.ts

@@ -0,0 +1,16 @@
+import type { ToolContext } from "../server.js";
+export declare function agentAddressTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+    };
+};
+export declare function runAgentAddress(ctx: ToolContext, _args: Record<string, unknown>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=agent-address.d.ts.map

package/dist/tools/agent-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-address.d.ts","sourceRoot":"","sources":["../../src/tools/agent-address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,gBAAgB;;;;;;;EAW/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAU/B"}

package/dist/tools/agent-address.js

@@ -0,0 +1,22 @@
+export function agentAddressTool() {
+    return {
+        name: "agent_address",
+        description: "Return the agent's Solana base58 public key (its on-chain identity). " +
+            "Send funds to this address to enable payments via payable_fetch.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    };
+}
+export async function runAgentAddress(ctx, _args) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: ctx.agent.address,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=agent-address.js.map

package/dist/tools/agent-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-address.js","sourceRoot":"","sources":["../../src/tools/agent-address.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,uEAAuE;YACvE,kEAAkE;QACpE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAgB,EAChB,KAA8B;IAE9B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO;aACxB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/agent-quote.d.ts

@@ -0,0 +1,33 @@
+import type { ToolContext } from "../server.js";
+export declare function agentQuoteTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function runAgentQuote(ctx: ToolContext, args: Record<string, unknown>): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=agent-quote.d.ts.map

package/dist/tools/agent-quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-quote.d.ts","sourceRoot":"","sources":["../../src/tools/agent-quote.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;EAoB7B;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GA2D9B"}

package/dist/tools/agent-quote.js

@@ -0,0 +1,78 @@
+import { detectFacilitator } from "@aifinpay/agent";
+export function agentQuoteTool() {
+    return {
+        name: "agent_quote",
+        description: "Inspect a 402 challenge for a URL WITHOUT paying. Returns the detected " +
+            "facilitator flavor and the merchant's quoted amount + fee preview. " +
+            "Use before payable_fetch to decide whether the cost is acceptable.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "Target URL (https)." },
+                method: {
+                    type: "string",
+                    enum: ["GET", "POST"],
+                    default: "GET",
+                },
+            },
+            required: ["url"],
+        },
+    };
+}
+export async function runAgentQuote(ctx, args) {
+    const url = String(args.url ?? "");
+    if (!url)
+        return errorResult("missing required arg: url");
+    const method = String(args.method ?? "GET").toUpperCase();
+    const resp = await ctx.agent.fetchImpl(url, { method });
+    if (resp.status !== 402) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: resp.status,
+                        note: resp.status === 200
+                            ? "no payment required — you can hit this without paying"
+                            : `unexpected status ${resp.status} on initial probe`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    try {
+        const facilitator = await detectFacilitator(resp);
+        let bodyPreview = null;
+        try {
+            bodyPreview = await resp.clone().json();
+        }
+        catch {
+            bodyPreview = (await resp.clone().text()).slice(0, 500);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        facilitator: facilitator.name,
+                        status: 402,
+                        note: "fee-on-top engine not yet wired — quote shows merchant terms only. " +
+                            "AiFinPay fee will be added on top at payment time.",
+                        merchant_terms: bodyPreview,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const err = e;
+        return errorResult(`could not detect facilitator: ${err.message}`);
+    }
+}
+function errorResult(...lines) {
+    return {
+        isError: true,
+        content: lines.map((line) => ({ type: "text", text: line })),
+    };
+}
+//# sourceMappingURL=agent-quote.js.map

package/dist/tools/agent-quote.js.map

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

package/dist/tools/pay-with-split.d.ts

@@ -0,0 +1,75 @@
+import type { ToolContext } from "../server.js";
+export declare function payWithSplitTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            chain: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            merchant_wallet: {
+                type: string;
+                description: string;
+            };
+            merchant_amount: {
+                type: string;
+                description: string;
+            };
+            order_id: {
+                type: string;
+                description: string;
+            };
+            fee_recipient: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function runPayWithSplit(ctx: ToolContext, args: Record<string, unknown>): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function quoteSplitTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            chain: {
+                type: string;
+                enum: string[];
+            };
+            merchant_amount: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function runQuoteSplit(ctx: ToolContext, args: Record<string, unknown>): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=pay-with-split.d.ts.map

package/dist/tools/pay-with-split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pay-with-split.d.ts","sourceRoot":"","sources":["../../src/tools/pay-with-split.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GAkC9B;AAED,wBAAgB,cAAc;;;;;;;;;;;;;;;;;EAqB7B;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GAkB9B"}

package/dist/tools/pay-with-split.js

@@ -0,0 +1,117 @@
+export function payWithSplitTool() {
+    return {
+        name: "pay_with_split",
+        description: "Get on-chain instructions for a fee-on-top atomic 3-way payment. " +
+            "The merchant receives the FULL quoted price; AiFinPay protocol fee " +
+            "(1%) and creator/referral fee (0.01%) are added ON TOP. The agent " +
+            "executes the returned instructions with their chain SDK of choice. " +
+            "Returns 503 with onboarding message if the splitter is not yet " +
+            "deployed on the requested chain.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["solana", "polygon"],
+                    description: "Chain to settle on.",
+                },
+                merchant_wallet: {
+                    type: "string",
+                    description: "Recipient — Solana base58 pubkey or Polygon 0x address.",
+                },
+                merchant_amount: {
+                    type: "string",
+                    description: "Merchant's quoted price in chain units (lamports for Solana, " +
+                        "wei for Polygon). Use a string to preserve precision.",
+                },
+                order_id: {
+                    type: "string",
+                    description: "Off-chain reference (max 64 chars).",
+                },
+                fee_recipient: {
+                    type: "string",
+                    description: "Optional — receives the IP-creator fee. Omit to route the " +
+                        "creator slot to AiFinPay treasury.",
+                },
+            },
+            required: ["chain", "merchant_wallet", "merchant_amount", "order_id"],
+        },
+    };
+}
+export async function runPayWithSplit(ctx, args) {
+    const chain = args.chain;
+    if (chain !== "solana" && chain !== "polygon") {
+        return errorResult("chain must be 'solana' or 'polygon'");
+    }
+    const merchantWallet = String(args.merchant_wallet ?? "");
+    const merchantAmount = String(args.merchant_amount ?? "");
+    const orderId = String(args.order_id ?? "");
+    if (!merchantWallet || !merchantAmount || !orderId) {
+        return errorResult("merchant_wallet, merchant_amount, and order_id are all required");
+    }
+    const feeRecipient = typeof args.fee_recipient === "string" && args.fee_recipient
+        ? args.fee_recipient
+        : undefined;
+    try {
+        const invoice = await ctx.agent.payWithSplitInvoice({
+            chain,
+            merchantWallet,
+            merchantAmount,
+            orderId,
+            feeRecipient,
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify(invoice, null, 2) }],
+        };
+    }
+    catch (e) {
+        const err = e;
+        return errorResult(`${err.constructor.name}: ${err.message}`);
+    }
+}
+export function quoteSplitTool() {
+    return {
+        name: "quote_split",
+        description: "Pure-view: compute the fee-on-top breakdown (merchant + treasury + " +
+            "creator + total) for a given merchant amount. No payment, no auth. " +
+            "Use this BEFORE pay_with_split to decide whether the cost is " +
+            "acceptable.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chain: { type: "string", enum: ["solana", "polygon"] },
+                merchant_amount: {
+                    type: "string",
+                    description: "Merchant's quoted price (lamports for Solana, wei for Polygon).",
+                },
+            },
+            required: ["chain", "merchant_amount"],
+        },
+    };
+}
+export async function runQuoteSplit(ctx, args) {
+    const chain = args.chain;
+    if (chain !== "solana" && chain !== "polygon") {
+        return errorResult("chain must be 'solana' or 'polygon'");
+    }
+    const merchantAmount = String(args.merchant_amount ?? "");
+    if (!merchantAmount)
+        return errorResult("merchant_amount required");
+    try {
+        const quote = await ctx.agent.quoteSplit({ chain, merchantAmount });
+        return {
+            content: [{ type: "text", text: JSON.stringify(quote, null, 2) }],
+        };
+    }
+    catch (e) {
+        const err = e;
+        return errorResult(`${err.constructor.name}: ${err.message}`);
+    }
+}
+function errorResult(...lines) {
+    return {
+        isError: true,
+        content: lines.map((line) => ({ type: "text", text: line })),
+    };
+}
+//# sourceMappingURL=pay-with-split.js.map

package/dist/tools/pay-with-split.js.map

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

package/dist/tools/payable-fetch.d.ts

@@ -0,0 +1,52 @@
+import type { ToolContext } from "../server.js";
+export declare function payableFetchTool(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            url: {
+                type: string;
+                description: string;
+            };
+            method: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            headers: {
+                type: string;
+                additionalProperties: {
+                    type: string;
+                };
+                description: string;
+            };
+            max_amount_usd: {
+                type: string;
+                description: string;
+            };
+            facilitator: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function runPayableFetch(ctx: ToolContext, args: Record<string, unknown>): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=payable-fetch.d.ts.map

package/dist/tools/payable-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payable-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/payable-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GA0D9B"}

package/dist/tools/payable-fetch.js

@@ -0,0 +1,93 @@
+export function payableFetchTool() {
+    return {
+        name: "payable_fetch",
+        description: "Fetch a URL that may require payment (HTTP 402). The agent automatically " +
+            "detects the x402 facilitator flavor, signs a payment, and retries. Returns " +
+            "the response status, headers, and body. Use this whenever an external " +
+            "service charges per-call and you want to pay autonomously.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "Target URL (https)." },
+                method: {
+                    type: "string",
+                    enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
+                    default: "GET",
+                },
+                body: {
+                    type: "string",
+                    description: "Request body (string). Set Content-Type via headers if non-JSON.",
+                },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Extra request headers.",
+                },
+                max_amount_usd: {
+                    type: "number",
+                    description: "Refuse to pay if the facilitator wants more than this. " +
+                        "Defaults to AIFINPAY_MAX_USD env or no cap.",
+                },
+                facilitator: {
+                    type: "string",
+                    description: "Force a facilitator: 'aifinpay' | 'coinbase-x402'. Default 'auto'.",
+                },
+            },
+            required: ["url"],
+        },
+    };
+}
+export async function runPayableFetch(ctx, args) {
+    const url = String(args.url ?? "");
+    if (!url)
+        return errorResult("missing required arg: url");
+    const method = String(args.method ?? "GET").toUpperCase();
+    const body = args.body ? String(args.body) : undefined;
+    const headers = typeof args.headers === "object" && args.headers !== null
+        ? args.headers
+        : undefined;
+    const maxAmountUsd = typeof args.max_amount_usd === "number"
+        ? args.max_amount_usd
+        : ctx.config.maxAmountUsd;
+    try {
+        const resp = await ctx.agent.pay(url, {
+            method,
+            body,
+            headers,
+            options: {
+                maxAmountUsd,
+                facilitator: typeof args.facilitator === "string"
+                    ? args.facilitator
+                    : undefined,
+            },
+        });
+        const respHeaders = {};
+        resp.headers.forEach((v, k) => (respHeaders[k] = v));
+        const text = await resp.text();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        status: resp.status,
+                        ok: resp.ok,
+                        headers: respHeaders,
+                        body: text,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const err = e;
+        return errorResult(`${err.constructor.name}: ${err.message}`, `Tip: ensure agent ${ctx.agent.address} has a funded Seat PDA. ` +
+            `Read more: https://aifinpay.company/docs`);
+    }
+}
+function errorResult(...lines) {
+    return {
+        isError: true,
+        content: lines.map((line) => ({ type: "text", text: line })),
+    };
+}
+//# sourceMappingURL=payable-fetch.js.map

package/dist/tools/payable-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payable-fetch.js","sourceRoot":"","sources":["../../src/tools/payable-fetch.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,2EAA2E;YAC3E,6EAA6E;YAC7E,wEAAwE;YACxE,4DAA4D;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBAC3D,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;oBAC/C,OAAO,EAAE,KAAK;iBACf;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,kEAAkE;iBACrE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxC,WAAW,EAAE,wBAAwB;iBACtC;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yDAAyD;wBACzD,6CAA6C;iBAChD;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,oEAAoE;iBACvE;aACF;YACD,QAAQ,EAAE,CAAC,KAAK,CAAC;SAClB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAgB,EAChB,IAA6B;IAE7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QACvD,CAAC,CAAE,IAAI,CAAC,OAAkC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,YAAY,GAChB,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ;QACrC,CAAC,CAAC,IAAI,CAAC,cAAc;QACrB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YACpC,MAAM;YACN,IAAI;YACJ,OAAO;YACP,OAAO,EAAE;gBACP,YAAY;gBACZ,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;oBAC/C,CAAC,CAAE,IAAI,CAAC,WAAsB;oBAC9B,CAAC,CAAC,SAAS;aACd;SACF,CAAC,CAAC;QAEH,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAE/B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,EAAE,EAAE,IAAI,CAAC,EAAE;wBACX,OAAO,EAAE,WAAW;wBACpB,IAAI,EAAE,IAAI;qBACX,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,CAAU,CAAC;QACvB,OAAO,WAAW,CAChB,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,EACzC,qBAAqB,GAAG,CAAC,KAAK,CAAC,OAAO,0BAA0B;YAC9D,0CAA0C,CAC7C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAG,KAAe;IACrC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@aifinpay/mcp",
+  "version": "0.1.0-alpha.2",
+  "description": "MCP server exposing AiFinPay's autonomous x402 payment loop as agent tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "aifinpay-mcp": "bin/aifinpay-mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "x402",
+    "ai-agent",
+    "mcp",
+    "model-context-protocol",
+    "payments",
+    "non-custodial",
+    "autonomous"
+  ],
+  "author": "CoinSecurities (SECCO) <contact@aifinpay.company>",
+  "license": "MIT",
+  "homepage": "https://github.com/AiFinPay/sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AiFinPay/sdk.git",
+    "directory": "mcp"
+  },
+  "bugs": "https://github.com/AiFinPay/sdk/issues",
+  "dependencies": {
+    "@aifinpay/agent": "^0.2.0-alpha.2",
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}