@aifinpay/mcp 0.1.0-alpha.6 → 1.0.1

package/README.md

@@ -6,11 +6,29 @@ MCP-aware agent runtime — your agent can now buy services autonomously.
 
 ## Tools
 
+### Payment / agent
 | 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. |
+| `payable_fetch(url, opts?)` | Fetch any URL. On HTTP 402, auto-detect the facilitator, sign, pay, and retry. |
+| `agent_call({provider, body})` | Pay a registered AiFinPay provider and return its response (unified call). |
+| `agent_quote(url)` | Inspect a 402 challenge without paying — quoted amount + facilitator flavor. |
+| `agent_address()` | Return the agent's address so you know where to fund it. |
+| `agent_claim_self(...)` | Publish/claim this agent on the public AiFinPay network directory. |
+| `pay_with_split(...)` | Execute a fee-on-top (B2B) split payment. |
+| `quote_split(...)` | Preview the fee-on-top split breakdown without paying. |
+
+### Marketplace directory (read-only)
+| Tool | What it does |
+|---|---|
+| `list_providers()` | List the AI services available through AiFinPay with per-call prices. |
+| `provider_info(name)` | Details for one provider (price, networks, service type). |
+| `provider_status()` | Which provider bridges are currently reachable. |
+| `service_coverage()` | Which categories AiFinPay covers and the providers in each. |
+| `network_stats()` | Public protocol statistics. |
+| `leaderboard()` | Public on-chain leaderboard of AiFinPay agents. |
+| `quote_cost(...)` | Preview the fee-on-top cost for a given price (no payment). |
+| `verify_passport(pubkey)` | Whether a key holds an AiFinPay AgentPassport. |
+| `agent_profile(address)` | Public profile + activity summary for an agent. |
 
 ## Install
 
@@ -38,8 +56,9 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
-Restart Claude Desktop. Now Claude can call `payable_fetch`, `agent_address`,
-and `agent_quote` like any other tool.
+Restart Claude Desktop. Now Claude can call any of the tools above —
+`payable_fetch`, `agent_call`, `pay_with_split`, and the read-only
+marketplace directory — like any other tool.
 
 ## First run — generating an agent
 
@@ -61,7 +80,7 @@ agent identity (and any funded Seat) persists across restarts.
 | 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_BASE_URL` | `https://aifinpay.io` | Backend URL for nonce + funding probes. |
 | `AIFINPAY_TIMEOUT_MS` | `30000` | Request timeout. |
 | `AIFINPAY_MAX_USD` | — | Hard cap per single payment. Strongly recommended. |
 
@@ -71,7 +90,7 @@ agent identity (and any funded Seat) persists across restarts.
 import { createServer, loadConfigFromEnv } from "@aifinpay/mcp";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
-const { server } = createServer({
+const { server } = await createServer({
   ...loadConfigFromEnv(),
   agentSecretB58: "your-secret-here",
   maxAmountUsd: 0.10,

package/bin/aifinpay-mcp.js

@@ -6,7 +6,7 @@
  *
  * Configure via env:
  *   AIFINPAY_AGENT_SECRET   base58 secret (load existing identity)
- *   AIFINPAY_BASE_URL       default https://aifinpay.company
+ *   AIFINPAY_BASE_URL       default https://aifinpay.io
  *   AIFINPAY_TIMEOUT_MS     default 30000
  *   AIFINPAY_MAX_USD        hard cap per single payment (no default)
  */

package/dist/directory.d.ts

@@ -0,0 +1,55 @@
+/**
+ * createDirectoryServer — the READ-ONLY MCP server submitted to the OpenAI
+ * ChatGPT App Directory. Distinct from `createServer` (the full BYO-MCP
+ * connector with payment execution): this one exposes ONLY the read-only
+ * directory tools, requires NO agent identity and NO auth, and never moves
+ * money — so it is reviewable under OpenAI's directory policy (Obsidian/32 /34).
+ *
+ * One codebase, two profiles: the HTTP wrapper picks this when
+ * AIFINPAY_MCP_PROFILE=directory.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export interface DirectoryServerConfig {
+    /** Public API base for the wrapped GET endpoints. Defaults to production. */
+    apiBase?: string;
+    /** Per-request timeout (ms). */
+    timeoutMs?: number;
+    log?: (level: "info" | "warn" | "error", msg: string) => void;
+}
+export declare function createDirectoryServer(config?: DirectoryServerConfig): Promise<{
+    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;
+    }>;
+}>;
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAYnE,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAwBD,wBAAsB,qBAAqB,CAAC,MAAM,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2B7E"}

package/dist/directory.js

@@ -0,0 +1,56 @@
+/**
+ * createDirectoryServer — the READ-ONLY MCP server submitted to the OpenAI
+ * ChatGPT App Directory. Distinct from `createServer` (the full BYO-MCP
+ * connector with payment execution): this one exposes ONLY the read-only
+ * directory tools, requires NO agent identity and NO auth, and never moves
+ * money — so it is reviewable under OpenAI's directory policy (Obsidian/32 /34).
+ *
+ * One codebase, two profiles: the HTTP wrapper picks this when
+ * AIFINPAY_MCP_PROFILE=directory.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { directoryTools, runDirectoryTool, DIRECTORY_API_BASE, } from "./tools/directory.js";
+// Server-wide instructions returned at initialize. ChatGPT/Codex use these as a
+// cross-tool guide (OpenAI readiness checklist item; the audit found it ABSENT
+// on the connector server). States the read-only contract, networks, and limits.
+const DIRECTORY_INSTRUCTIONS = [
+    "AiFinPay is payment infrastructure for AI agents. THIS server is the",
+    "read-only directory surface: it answers questions about the AiFinPay agent",
+    "economy and prices AI services — it does NOT move money, hold funds, sign",
+    "transactions, or execute any payment. Every tool is read-only.",
+    "",
+    "Use it to: list available AI providers and their per-call prices",
+    "(list_providers / provider_info / provider_status / service_coverage),",
+    "preview a fee-on-top cost breakdown without paying (quote_cost), read public",
+    "protocol stats (network_stats) and the on-chain agent leaderboard",
+    "(leaderboard), verify an agent's AgentPassport (verify_passport), and look up",
+    "a public agent profile (agent_profile).",
+    "",
+    "Networks: Polygon and Solana mainnet. Data is public on-chain / registry",
+    "information. To actually execute a payment, an agent uses the separate",
+    "AiFinPay connector or SDK — not this directory app. Requests are rate limited;",
+    "on HTTP 429 (rate_limit_exceeded), back off and retry.",
+].join("\n");
+export async function createDirectoryServer(config = {}) {
+    const log = config.log ?? ((lvl, msg) => process.stderr.write(`[${lvl}] ${msg}\n`));
+    const ctx = {
+        apiBase: (config.apiBase || DIRECTORY_API_BASE).replace(/\/$/, ""),
+        timeoutMs: config.timeoutMs ?? 15000,
+        log,
+    };
+    const server = new Server({ name: "@aifinpay/mcp-directory", version: "1.0.0" }, {
+        capabilities: { tools: {} },
+        instructions: DIRECTORY_INSTRUCTIONS,
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: directoryTools(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return runDirectoryTool(ctx, name, args ?? {});
+    });
+    log("info", `[aifinpay-mcp-directory] read-only profile · api=${ctx.apiBase}`);
+    return { server };
+}
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAU9B,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,MAAM,sBAAsB,GAAG;IAC7B,sEAAsE;IACtE,4EAA4E;IAC5E,2EAA2E;IAC3E,gEAAgE;IAChE,EAAE;IACF,kEAAkE;IAClE,wEAAwE;IACxE,8EAA8E;IAC9E,mEAAmE;IACnE,+EAA+E;IAC/E,yCAAyC;IACzC,EAAE;IACF,0EAA0E;IAC1E,wEAAwE;IACxE,gFAAgF;IAChF,wDAAwD;CACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAgC,EAAE;IAC5E,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAqB;QAC5B,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAClE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;QACpC,GAAG;KACJ,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,EAAE,EACrD;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EAAE,sBAAsB;KACrC,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,cAAc,EAAE;KACxB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,EAAE,oDAAoD,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -18,11 +18,13 @@
  *   import { createServer } from "@aifinpay/mcp";
  *   import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
  *
- *   const { server } = createServer({ agentSecretB58: process.env.SECRET });
+ *   const { server } = await 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";
+export { createDirectoryServer } from "./directory.js";
+export type { DirectoryServerConfig } from "./directory.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;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;AAIhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -18,9 +18,12 @@
  *   import { createServer } from "@aifinpay/mcp";
  *   import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
  *
- *   const { server } = createServer({ agentSecretB58: process.env.SECRET });
+ *   const { server } = await createServer({ agentSecretB58: process.env.SECRET });
  *   await server.connect(new StdioServerTransport());
  */
 export { createServer } from "./server.js";
 export { loadConfigFromEnv } from "./config.js";
+// Read-only directory profile — the surface submitted to the OpenAI ChatGPT App
+// Directory (no agent, no auth, no payment execution). See directory.ts.
+export { createDirectoryServer } from "./directory.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,gFAAgF;AAChF,yEAAyE;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAS,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAa7C;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,GAAE,SAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFxD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAS,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAa7C;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,GAAE,SAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGxD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,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

@@ -39,10 +39,21 @@ export async function createServer(config = {}) {
                 `  >> Save the secret to AIFINPAY_AGENT_SECRET to keep the agent across restarts.`);
             return a;
         })();
+    // AIFINPAY_MAX_USD is the documented "hard cap on a single payment".
+    // payable_fetch enforces it via PayOptions, but agent_call settles through
+    // AiFinPayAgent.call() which only honours the agent's budget caps — wire
+    // the cap there too, otherwise the primary tool has NO runaway protection.
+    if (config.maxAmountUsd !== undefined && Number.isFinite(config.maxAmountUsd)) {
+        agent.setBudget({ per_call_usd: config.maxAmountUsd });
+        log("info", `[aifinpay-mcp] per-call cap: $${config.maxAmountUsd} (AIFINPAY_MAX_USD)`);
+    }
+    else {
+        log("warn", "[aifinpay-mcp] AIFINPAY_MAX_USD not set — agent_call/payable_fetch have NO per-payment cap. Strongly recommended.");
+    }
     log("info", `[aifinpay-mcp] solana: ${agent.solanaAddress} · evm: ${agent.evmAddress}`);
     const server = new Server({
         name: "@aifinpay/mcp",
-        version: "0.1.0-alpha.3",
+        version: "1.0.0",
     }, {
         capabilities: {
             tools: {},

package/dist/server.js.map

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

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

@@ -6,11 +6,38 @@ export declare function agentAddressTool(): {
         type: string;
         properties: {};
     };
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    outputSchema: {
+        type: string;
+        properties: {
+            solana: {
+                type: string;
+                description: string;
+            };
+            evm: {
+                type: string;
+                description: string;
+            };
+            note: {
+                type: string;
+            };
+        };
+        required: string[];
+    };
 };
 export declare function runAgentAddress(ctx: ToolContext, _args: Record<string, unknown>): Promise<{
     content: {
         type: string;
         text: string;
     }[];
+    structuredContent: {
+        solana: string;
+        evm: string;
+        note: string;
+    };
 }>;
 //# sourceMappingURL=agent-address.d.ts.map

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

@@ -1 +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;;;;;;;EAc/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAe/B"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;GAgB/B"}

package/dist/tools/agent-address.js

@@ -10,6 +10,17 @@ export function agentAddressTool() {
             type: "object",
             properties: {},
         },
+        // OpenAI Apps SDK requires impact hints on every tool (omitting = validation error).
+        annotations: { readOnlyHint: true, openWorldHint: false, destructiveHint: false },
+        outputSchema: {
+            type: "object",
+            properties: {
+                solana: { type: "string", description: "Solana base58 address" },
+                evm: { type: "string", description: "Polygon/EVM address" },
+                note: { type: "string" },
+            },
+            required: ["solana", "evm"],
+        },
     };
 }
 export async function runAgentAddress(ctx, _args) {
@@ -24,6 +35,7 @@ export async function runAgentAddress(ctx, _args) {
         content: [
             { type: "text", text: JSON.stringify(payload, null, 2) },
         ],
+        structuredContent: payload,
     };
 }
 //# sourceMappingURL=agent-address.js.map

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

@@ -1 +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,mEAAmE;YACnE,yEAAyE;YACzE,oEAAoE;YACpE,oEAAoE;YACpE,0EAA0E;QAC5E,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,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa;QAC/B,GAAG,EAAK,GAAG,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,EACF,iEAAiE;YACjE,oEAAoE;YACpE,0EAA0E;KAC7E,CAAC;IACF,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACzD;KACF,CAAC;AACJ,CAAC"}
+{"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,mEAAmE;YACnE,yEAAyE;YACzE,oEAAoE;YACpE,oEAAoE;YACpE,0EAA0E;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,qFAAqF;QACrF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;QACjF,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAChE,GAAG,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;gBAC9D,IAAI,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAgB,EAChB,KAA8B;IAE9B,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa;QAC/B,GAAG,EAAK,GAAG,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,EACF,iEAAiE;YACjE,oEAAoE;YACpE,0EAA0E;KAC7E,CAAC;IACF,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACzD;QACD,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC"}

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

@@ -43,6 +43,14 @@ export declare function agentCallTool(): {
         };
         required: string[];
     };
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    outputSchema: {
+        type: string;
+    };
 };
 export declare function runAgentCall(ctx: ToolContext, args: Record<string, unknown>): Promise<{
     isError: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"agent-call.d.ts","sourceRoot":"","sources":["../../src/tools/agent-call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqC5B;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAqD9B"}
+{"version":3,"file":"agent-call.d.ts","sourceRoot":"","sources":["../../src/tools/agent-call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD5B;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAkE9B"}

package/dist/tools/agent-call.js

@@ -17,13 +17,21 @@
 export function agentCallTool() {
     return {
         name: "agent_call",
-        description: "Make a paid call to any AiFinPay-registered provider by name. " +
-            "Provider names come from https://aifinpay.company/api/providers — " +
-            "currently 'exa' (search), 'io-net' (Llama-3.3-70B inference), " +
-            "'venice' (image generation), more added per partner integration. " +
-            "Body is the provider-specific request (e.g. {messages:[...]} for " +
-            "io-net, {query:'...'} for exa). Returns the full upstream response. " +
-            "Settlement: Polygon mainnet, atomic 99/1 split via B2BSplitter.",
+        description: "USE THIS TOOL whenever the user asks to call, pay, query, search via, " +
+            "or use any of these AiFinPay-registered paid providers: 'exa' (neural " +
+            "web search), 'io-net' (LLM inference, Llama-3.3-70B), 'venice' (image " +
+            "generation), or any other provider listed at " +
+            "https://aifinpay.io/api/providers. " +
+            "DO NOT use WebSearch or WebFetch for these providers — they are paid " +
+            "APIs accessible only through this MCP, and a plain web search will " +
+            "return public marketing pages instead of the actual API. " +
+            "Natural-language triggers that should invoke this tool: 'call exa for X', " +
+            "'search exa', 'pay venice to generate Y', 'use io-net to run inference', " +
+            "'query exa', 'ask io-net'. Provider name maps to the `provider` argument. " +
+            "Body is the provider-specific request shape (e.g. {messages:[...]} for " +
+            "io-net inference, {query:'...'} for exa search). Returns the upstream " +
+            "response with the Polygon tx hash + Polygonscan link prepended. " +
+            "Settlement is automatic — Polygon mainnet, atomic 99/1 split via B2BSplitter.",
         inputSchema: {
             type: "object",
             properties: {
@@ -49,6 +57,9 @@ export function agentCallTool() {
             },
             required: ["provider"],
         },
+        // Settles a real on-chain payment to an arbitrary registered provider.
+        annotations: { readOnlyHint: false, openWorldHint: true, destructiveHint: true },
+        outputSchema: { type: "object" },
     };
 }
 export async function runAgentCall(ctx, args) {
@@ -81,13 +92,23 @@ export async function runAgentCall(ctx, args) {
             parsed = JSON.parse(text);
         }
         catch { /* keep as text */ }
+        // Pull the @internal settlement metadata attached by AiFinPayAgent.call
+        // (see unifiedAgent.ts). Surfacing the tx hash here lets the agent show
+        // a clickable explorer link in chat without re-querying the chain.
+        const meta = resp;
+        const txHash = meta.aifinpayTx;
+        const txChain = meta.aifinpayChain;
+        const txLine = txHash
+            ? `Paid on ${txChain ?? "polygon"}. Tx: ${txHash} → https://${txChain === "solana" ? "solscan.io/tx" : "polygonscan.com/tx"}/${txHash}\n\n`
+            : "";
+        const bodyText = typeof parsed === "string"
+            ? parsed
+            : JSON.stringify({ status: resp.status, body: parsed }, null, 2);
         return {
             content: [
                 {
                     type: "text",
-                    text: typeof parsed === "string"
-                        ? parsed
-                        : JSON.stringify({ status: resp.status, body: parsed }, null, 2),
+                    text: txLine + bodyText,
                 },
             ],
         };
@@ -98,7 +119,7 @@ export async function runAgentCall(ctx, args) {
             ? "Tip: increase the per-call cost cap or use `agent_quote` to preview before paying."
             : message.toLowerCase().includes("revert") || message.toLowerCase().includes("insufficient")
                 ? `Tip: ensure the EVM address ${ctx.agent.evmAddress} holds enough POL on Polygon for gas + payment.`
-                : `Provider may be misconfigured. Check https://aifinpay.company/api/providers.`;
+                : `Provider may be misconfigured. Check https://aifinpay.io/api/providers.`;
         return {
             isError: true,
             content: [{ type: "text", text: `agent_call failed: ${message}\n\n${hint}` }],

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

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

package/dist/tools/agent-claim-self.d.ts

@@ -4,8 +4,8 @@ import type { ToolContext } from "../server.js";
  * autonomously by signing a claim challenge with its own key.
  *
  * Flow (executed inside the tool, no copy-paste between UIs):
- *   1. User signs in to /login on aifinpay.company → gets a magic-link
- *      email with URL like `https://aifinpay.company/api/auth/verify?token=…`
+ *   1. User signs in to /login on aifinpay.io → gets a magic-link
+ *      email with URL like `https://aifinpay.io/api/auth/verify?token=…`
  *   2. User pastes that URL to the agent: "claim yourself on my account
  *      using this magic link"
  *   3. Agent calls this tool with the magic_link_url
@@ -41,6 +41,14 @@ export declare function agentClaimSelfTool(): {
         };
         required: string[];
     };
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        destructiveHint: boolean;
+    };
+    outputSchema: {
+        type: string;
+    };
 };
 export declare function runAgentClaimSelf(ctx: ToolContext, args: Record<string, unknown>): Promise<{
     isError: boolean;

package/dist/tools/agent-claim-self.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-claim-self.d.ts","sourceRoot":"","sources":["../../src/tools/agent-claim-self.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;EA6BjC;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GA0I9B"}
+{"version":3,"file":"agent-claim-self.d.ts","sourceRoot":"","sources":["../../src/tools/agent-claim-self.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;EAgCjC;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAgL9B"}

package/dist/tools/agent-claim-self.js

@@ -3,8 +3,8 @@
  * autonomously by signing a claim challenge with its own key.
  *
  * Flow (executed inside the tool, no copy-paste between UIs):
- *   1. User signs in to /login on aifinpay.company → gets a magic-link
- *      email with URL like `https://aifinpay.company/api/auth/verify?token=…`
+ *   1. User signs in to /login on aifinpay.io → gets a magic-link
+ *      email with URL like `https://aifinpay.io/api/auth/verify?token=…`
  *   2. User pastes that URL to the agent: "claim yourself on my account
  *      using this magic link"
  *   3. Agent calls this tool with the magic_link_url
@@ -28,7 +28,7 @@ export function agentClaimSelfTool() {
         name: "agent_claim_self",
         description: "Attach this agent to a user's AiFinPay account autonomously. " +
             "Requires a magic-link URL the user got after signing in at " +
-            "https://aifinpay.company/login. The tool will use the link to " +
+            "https://aifinpay.io/login. The tool will use the link to " +
             "establish a session, request a claim challenge for this agent's " +
             "EVM address, sign it with the agent's key, and submit the proof. " +
             "After this completes, the user's /me page lists this agent and " +
@@ -39,7 +39,7 @@ export function agentClaimSelfTool() {
                 magic_link_url: {
                     type: "string",
                     description: "The URL the user received in the sign-in email. Looks like " +
-                        "https://aifinpay.company/api/auth/verify?token=… — one-shot, " +
+                        "https://aifinpay.io/api/auth/verify?token=… — one-shot, " +
                         "expires 15 minutes after the user requested it.",
                 },
                 label: {
@@ -49,6 +49,9 @@ export function agentClaimSelfTool() {
             },
             required: ["magic_link_url"],
         },
+        // Binds the agent to a user account (bounded to AiFinPay; not fund-moving).
+        annotations: { readOnlyHint: false, openWorldHint: false, destructiveHint: false },
+        outputSchema: { type: "object" },
     };
 }
 export async function runAgentClaimSelf(ctx, args) {
@@ -57,7 +60,7 @@ export async function runAgentClaimSelf(ctx, args) {
     if (!magicLinkUrl || !magicLinkUrl.includes("/api/auth/verify?token=")) {
         return {
             isError: true,
-            content: [{ type: "text", text: "magic_link_url required — should look like https://aifinpay.company/api/auth/verify?token=…" }],
+            content: [{ type: "text", text: "magic_link_url required — should look like https://aifinpay.io/api/auth/verify?token=…" }],
         };
     }
     // Derive API base from the magic link itself so demo can run against
@@ -155,8 +158,46 @@ export async function runAgentClaimSelf(ctx, args) {
     catch (e) {
         solRes = { ok: false, reason: `solana_signer_unavailable: ${e.message}` };
     }
-    // ── 4. Report ──────────────────────────────────────────────────────
+    // ── 4. Balance check (best-effort) — drives funded-vs-unfunded copy ─
+    // Never block the claim flow on a balance check; if the RPC is down or
+    // balance() throws, fall back to the standard funding recommendation.
+    let polygonUsdc = 0;
+    let solanaUsdc = 0;
     try {
+        const bal = await ctx.agent.balance();
+        polygonUsdc = bal.chains.polygon.usdc ?? 0;
+        solanaUsdc = bal.chains.solana.usdc ?? 0;
+    }
+    catch {
+        /* swallow — keep funding_recommendation as-is */
+    }
+    // ── 5. Report ──────────────────────────────────────────────────────
+    try {
+        // Dashboard URLs live at dashboard.aifinpay.io regardless of
+        // which host the user used for magic-link sign-in. apiBase is correct
+        // only for /me (which lives at whichever host the user signed in via).
+        const DASHBOARD_BASE = "https://dashboard.aifinpay.io";
+        // Funded threshold: 0.10 USDC (~4 io-net calls). Below this we still
+        // show the funding tip; at-or-above we show a "Funded" status so the
+        // agent doesn't tell the user to send money they already sent.
+        const FUNDED_USDC_THRESHOLD = 0.10;
+        const polygonFunded = polygonUsdc >= FUNDED_USDC_THRESHOLD;
+        const fundingFields = polygonFunded
+            ? {
+                funding_status: `Funded — $${polygonUsdc.toFixed(2)} USDC available on Polygon`,
+            }
+            : {
+                // Live bridges (io.net, Exa, Venice) settle on Polygon — fund
+                // the Polygon address with USDC for autonomous calls today.
+                // Solana is claimed for visibility; SOL-native settlement is
+                // available on bridges that advertise pay_solana in their 402.
+                funding_recommendation: `Send USDC on Polygon to ${evmAddr} (~0.5 USDC ≈ 20 calls). Optionally fund the Solana address with SOL to use Solana-native bridges.`,
+            };
+        // Surface Solana USDC status when balance() exposes a non-zero value;
+        // schema doesn't currently include solana.usdc but future-proof here.
+        if (solanaUsdc >= FUNDED_USDC_THRESHOLD) {
+            fundingFields.funding_status_solana = `Funded — $${solanaUsdc.toFixed(2)} USDC available on Solana`;
+        }
         return {
             content: [
                 {
@@ -168,12 +209,8 @@ export async function runAgentClaimSelf(ctx, args) {
                         solana_address: solAddr,
                         solana_claim: solRes.ok ? "ok" : `skipped (${solRes.reason})`,
                         label: label || null,
-                        // Live bridges (io.net, Exa, Venice) settle on Polygon — fund
-                        // the Polygon address with USDC for autonomous calls today.
-                        // Solana is claimed for visibility; SOL-native settlement is
-                        // available on bridges that advertise pay_solana in their 402.
-                        funding_recommendation: `Send USDC on Polygon to ${evmAddr} (~0.5 USDC ≈ 20 calls). Optionally fund the Solana address with SOL to use Solana-native bridges.`,
-                        next: `Visit ${apiBase}/agents/${evmAddr} (Polygon view) or ${apiBase}/agents/${solAddr} (Solana view). Watchlist: ${apiBase}/me.`,
+                        ...fundingFields,
+                        next: `Visit ${DASHBOARD_BASE}/agents/${evmAddr} (Polygon view) or ${DASHBOARD_BASE}/agents/${solAddr} (Solana view). Watchlist: ${apiBase}/me.`,
                     }, null, 2),
                 },
             ],