@aifinpay/mcp 1.1.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -6,8 +6,12 @@ MCP-aware agent runtime — your agent can now buy services autonomously.
|
|
|
6
6
|
|
|
7
7
|
Canonical domain: **aifinpay.io** (the legacy `aifinpay.company` host is
|
|
8
8
|
retired — ignore any docs pointing there). SDK settlement runs on
|
|
9
|
-
**Polygon (default) and Solana**; the
|
|
10
|
-
|
|
9
|
+
**Polygon (default) and Solana**; the underlying Node SDK (≥ 1.3.0) also
|
|
10
|
+
supports direct splitter settlement on Base, Optimism, Unichain, BOT Chain
|
|
11
|
+
and XRPL EVM (native-token path), while the MCP `pay_with_split` /
|
|
12
|
+
`quote_split` tools stay Polygon + Solana (backend invoice flow). The
|
|
13
|
+
protocol itself is live across 13 networks — see
|
|
14
|
+
[aifinpay.io/llms.txt](https://aifinpay.io/llms.txt).
|
|
11
15
|
|
|
12
16
|
## Tools
|
|
13
17
|
|
|
@@ -16,6 +20,10 @@ networks — see [aifinpay.io/llms.txt](https://aifinpay.io/llms.txt).
|
|
|
16
20
|
| `payable_fetch(url, opts?)` | Fetch any URL. On 402, auto-detect facilitator, sign, retry. |
|
|
17
21
|
| `agent_address()` | Return the agent's funding addresses on **both** chains — Polygon `0x…` (default settlement: io.net, Exa, Venice bridges) and Solana base58 (Seat PDA / leaderboard). One seed, two chains — fund either. |
|
|
18
22
|
| `agent_quote(url)` | Inspect a 402 challenge without paying. Shows the merchant's quoted amount + facilitator flavor. |
|
|
23
|
+
| `agent_call(provider, …)` | Call a live provider from the AiFinPay directory (io.net, Exa, Venice, …) with automatic payment. |
|
|
24
|
+
| `pay_with_split(chain, merchant, amount, …)` | Direct fee-on-top payment to any merchant wallet — merchant receives 100% of the amount, AiFinPay adds 1% on top. |
|
|
25
|
+
| `quote_split(chain, amount)` | Preview the exact on-chain amounts of a `pay_with_split` before paying. |
|
|
26
|
+
| `agent_claim_self(magic_link_url)` | Link this agent to your dashboard account via a one-shot magic link from `aifinpay.io/login` — spend history shows up in the dashboard. |
|
|
19
27
|
|
|
20
28
|
## Install
|
|
21
29
|
|
|
@@ -1 +1 @@
|
|
|
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;
|
|
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;AAahD,wBAAgB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2C/B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GAqC9B;AAED,wBAAgB,cAAc;;;;;;;;;;;;;;;;;EAqB7B;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GAmB9B"}
|
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
// NOTE on the chain enum below: pay_with_split and quote_split are
|
|
2
|
+
// BACKEND-INVOICE-DRIVEN — they call the operator API
|
|
3
|
+
// (POST /api/b2b/pay-with-split, GET /api/b2b/quote-split), which supports
|
|
4
|
+
// solana + 6 on-chain-verified EVM chains (polygon, base, optimism,
|
|
5
|
+
// unichain, botchain, xrplevm). Keep this enum in lockstep with the
|
|
6
|
+
// backend's ../evm-chains.js registry — a chain listed here without
|
|
7
|
+
// backend support would just be rejected server-side. Stables: USDC on
|
|
8
|
+
// base/optimism/unichain, USDC+USDT on polygon; botchain/xrplevm are
|
|
9
|
+
// native-token only. Direct (non-invoice) splitter settlement lives in
|
|
10
|
+
// the SDK's AiFinPayAgent.call() (@aifinpay/agent >= 1.3.0).
|
|
1
11
|
export function payWithSplitTool() {
|
|
2
12
|
return {
|
|
3
13
|
name: "pay_with_split",
|
|
@@ -12,7 +22,7 @@ export function payWithSplitTool() {
|
|
|
12
22
|
properties: {
|
|
13
23
|
chain: {
|
|
14
24
|
type: "string",
|
|
15
|
-
enum: ["solana", "polygon"],
|
|
25
|
+
enum: ["solana", "polygon", "base", "optimism", "unichain", "botchain", "xrplevm"],
|
|
16
26
|
description: "Chain to settle on.",
|
|
17
27
|
},
|
|
18
28
|
merchant_wallet: {
|
|
@@ -40,8 +50,8 @@ export function payWithSplitTool() {
|
|
|
40
50
|
}
|
|
41
51
|
export async function runPayWithSplit(ctx, args) {
|
|
42
52
|
const chain = args.chain;
|
|
43
|
-
if (chain
|
|
44
|
-
return errorResult("chain must be 'solana' or '
|
|
53
|
+
if (!chain || !["solana", "polygon", "base", "optimism", "unichain", "botchain", "xrplevm"].includes(chain)) {
|
|
54
|
+
return errorResult("chain must be 'solana', 'polygon', 'base', 'optimism', 'unichain', 'botchain' or 'xrplevm'");
|
|
45
55
|
}
|
|
46
56
|
const merchantWallet = String(args.merchant_wallet ?? "");
|
|
47
57
|
const merchantAmount = String(args.merchant_amount ?? "");
|
|
@@ -54,7 +64,10 @@ export async function runPayWithSplit(ctx, args) {
|
|
|
54
64
|
: undefined;
|
|
55
65
|
try {
|
|
56
66
|
const invoice = await ctx.agent.inner.payWithSplitInvoice({
|
|
57
|
-
|
|
67
|
+
// published @aifinpay/agent (<=1.3.0) still types this "solana"|"polygon";
|
|
68
|
+
// the value is forwarded verbatim to the backend, which accepts all 7.
|
|
69
|
+
// Drop the cast once agent >=1.3.1 (widened types) is published.
|
|
70
|
+
chain: chain,
|
|
58
71
|
merchantWallet,
|
|
59
72
|
merchantAmount,
|
|
60
73
|
orderId,
|
|
@@ -79,7 +92,7 @@ export function quoteSplitTool() {
|
|
|
79
92
|
inputSchema: {
|
|
80
93
|
type: "object",
|
|
81
94
|
properties: {
|
|
82
|
-
chain: { type: "string", enum: ["solana", "polygon"] },
|
|
95
|
+
chain: { type: "string", enum: ["solana", "polygon", "base", "optimism", "unichain", "botchain", "xrplevm"] },
|
|
83
96
|
merchant_amount: {
|
|
84
97
|
type: "string",
|
|
85
98
|
description: "Merchant's quoted price (lamports for Solana, wei for Polygon).",
|
|
@@ -91,14 +104,15 @@ export function quoteSplitTool() {
|
|
|
91
104
|
}
|
|
92
105
|
export async function runQuoteSplit(ctx, args) {
|
|
93
106
|
const chain = args.chain;
|
|
94
|
-
if (chain
|
|
95
|
-
return errorResult("chain must be 'solana' or '
|
|
107
|
+
if (!chain || !["solana", "polygon", "base", "optimism", "unichain", "botchain", "xrplevm"].includes(chain)) {
|
|
108
|
+
return errorResult("chain must be 'solana', 'polygon', 'base', 'optimism', 'unichain', 'botchain' or 'xrplevm'");
|
|
96
109
|
}
|
|
97
110
|
const merchantAmount = String(args.merchant_amount ?? "");
|
|
98
111
|
if (!merchantAmount)
|
|
99
112
|
return errorResult("merchant_amount required");
|
|
100
113
|
try {
|
|
101
|
-
|
|
114
|
+
// Same published-type lag as above — cast until agent >=1.3.1 ships.
|
|
115
|
+
const quote = await ctx.agent.inner.quoteSplit({ chain: chain, merchantAmount });
|
|
102
116
|
return {
|
|
103
117
|
content: [{ type: "text", text: JSON.stringify(quote, null, 2) }],
|
|
104
118
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pay-with-split.js","sourceRoot":"","sources":["../../src/tools/pay-with-split.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mEAAmE;YACnE,qEAAqE;YACrE,oEAAoE;YACpE,qEAAqE;YACrE,iEAAiE;YACjE,kCAAkC;QACpC,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"pay-with-split.js","sourceRoot":"","sources":["../../src/tools/pay-with-split.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aifinpay/mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "Pay-per-call MCP server for autonomous AI agents — installs in Claude Desktop / Cursor / Continue with one config block; on-chain settlement on Polygon and Solana via x402.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|