@paystage/mcp 0.1.0 → 0.2.1
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 +63 -23
- package/dist/cli.js +0 -0
- package/dist/index.js +0 -0
- package/dist/server.d.ts +1 -1
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +70 -0
- package/dist/server.js.map +1 -1
- package/package.json +8 -4
- package/server.json +6 -5
package/README.md
CHANGED
|
@@ -1,35 +1,27 @@
|
|
|
1
1
|
# @paystage/mcp
|
|
2
2
|
|
|
3
|
-
PayStage umbrella MCP server: payment preflight
|
|
3
|
+
PayStage umbrella MCP server: payment preflight, auth watch, and HIP-3 trade preflight.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
> Not financial advice. The trade preflight tool is a local policy gate only — it does not
|
|
6
|
+
> place orders or recommend trades.
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Published on npm as **`@paystage/mcp@0.2.0`**.
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
## Install
|
|
11
|
+
|
|
12
|
+
```sh
|
|
11
13
|
npx -y @paystage/mcp
|
|
12
14
|
```
|
|
13
15
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
| Tool | Description |
|
|
17
|
-
| --- | --- |
|
|
18
|
-
| `evaluate_mcp_payment` | Evaluate an x402 `PaymentRequired` payload against a PayStage spending policy before paying. |
|
|
19
|
-
| `list_outstanding_auths` | List outstanding token authorizations (EIP-3009 / allowances) for a wallet. |
|
|
20
|
-
| `evaluate_outstanding_auths` | List outstanding token authorizations and evaluate them against a policy. |
|
|
21
|
-
|
|
22
|
-
## Environment variables
|
|
16
|
+
Or:
|
|
23
17
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
| `PAYSTAGE_RPC_URL` | No | RPC URL used for on-chain reads. Defaults to a public Base RPC. |
|
|
18
|
+
```sh
|
|
19
|
+
npm install @paystage/mcp
|
|
20
|
+
```
|
|
28
21
|
|
|
29
|
-
|
|
22
|
+
The package exposes a `stdio` MCP server (bin: `paystage-mcp`).
|
|
30
23
|
|
|
31
|
-
|
|
32
|
-
`mcp.json`):
|
|
24
|
+
## MCP configuration
|
|
33
25
|
|
|
34
26
|
```json
|
|
35
27
|
{
|
|
@@ -38,14 +30,62 @@ Add to your MCP client config (e.g. `claude_desktop_config.json` or Cursor's
|
|
|
38
30
|
"command": "npx",
|
|
39
31
|
"args": ["-y", "@paystage/mcp"],
|
|
40
32
|
"env": {
|
|
41
|
-
"PAYSTAGE_POLICY_PATH": "
|
|
42
|
-
"PAYSTAGE_RPC_URL": "https://mainnet.base.org"
|
|
33
|
+
"PAYSTAGE_POLICY_PATH": "./policy.json"
|
|
43
34
|
}
|
|
44
35
|
}
|
|
45
36
|
}
|
|
46
37
|
}
|
|
47
38
|
```
|
|
48
39
|
|
|
40
|
+
Environment variables (all optional):
|
|
41
|
+
|
|
42
|
+
- `PAYSTAGE_POLICY_PATH` — path to `policy.json` spending rules
|
|
43
|
+
- `PAYSTAGE_RPC_URL` — Base RPC URL override
|
|
44
|
+
|
|
45
|
+
## Tools
|
|
46
|
+
|
|
47
|
+
### `evaluate_mcp_payment` — Available now
|
|
48
|
+
|
|
49
|
+
Evaluates a proposed x402 payment against a local policy file and returns a verdict before
|
|
50
|
+
the agent signs anything.
|
|
51
|
+
|
|
52
|
+
### `list_outstanding_auths` — Available now
|
|
53
|
+
|
|
54
|
+
Lists outstanding ERC-20, Permit2, and EIP-3009 authorizations.
|
|
55
|
+
|
|
56
|
+
### `evaluate_outstanding_auths` — Available now
|
|
57
|
+
|
|
58
|
+
Flags outstanding authorizations that need attention (e.g. authorized but never settled).
|
|
59
|
+
|
|
60
|
+
### `evaluate_hip3_trade` — Available now
|
|
61
|
+
|
|
62
|
+
Evaluates a proposed HIP-3 / trade.xyz order against a local `TradePolicy` and returns a
|
|
63
|
+
decision: `allow` | `review` | `do_not_trade`.
|
|
64
|
+
|
|
65
|
+
Backed by [`@paystage/trade-preflight`](https://www.npmjs.com/package/@paystage/trade-preflight)
|
|
66
|
+
(`0.1.0`), which is also published on npm and can be run standalone:
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
npx -y @paystage/trade-preflight
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The policy is passed as a tool argument; no extra environment variables are required for
|
|
73
|
+
this tool.
|
|
74
|
+
|
|
75
|
+
## Packages
|
|
76
|
+
|
|
77
|
+
| Package | Version | Purpose |
|
|
78
|
+
| --- | --- | --- |
|
|
79
|
+
| `@paystage/mcp` | 0.2.0 | Umbrella server (4 tools) |
|
|
80
|
+
| `@paystage/auth-watch` | 0.1.0 | Outstanding-auth tools |
|
|
81
|
+
| `@paystage/trade-preflight` | 0.1.2 | HIP-3 / trade.xyz trade preflight |
|
|
82
|
+
|
|
83
|
+
## Links
|
|
84
|
+
|
|
85
|
+
- Website: [paystage.xyz](https://paystage.xyz)
|
|
86
|
+
- HIP-3 context: [docs.trade.xyz](https://docs.trade.xyz)
|
|
87
|
+
- Source: [github.com/base-buzz/paystage](https://github.com/base-buzz/paystage)
|
|
88
|
+
|
|
49
89
|
## License
|
|
50
90
|
|
|
51
91
|
MIT
|
package/dist/cli.js
CHANGED
|
File without changes
|
package/dist/index.js
CHANGED
|
File without changes
|
package/dist/server.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
-
export declare const TOOL_NAMES: readonly ["evaluate_mcp_payment", "list_outstanding_auths", "evaluate_outstanding_auths"];
|
|
2
|
+
export declare const TOOL_NAMES: readonly ["evaluate_mcp_payment", "list_outstanding_auths", "evaluate_outstanding_auths", "evaluate_hip3_trade", "evaluate_velocity"];
|
|
3
3
|
export type ToolName = (typeof TOOL_NAMES)[number];
|
|
4
4
|
export declare function createServer(): McpServer;
|
|
5
5
|
export declare function getToolNames(): string[];
|
package/dist/server.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCpE,eAAO,MAAM,UAAU,uIAMb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AA8PnD,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}
|
package/dist/server.js
CHANGED
|
@@ -4,10 +4,14 @@ import { z } from "zod";
|
|
|
4
4
|
import { loadPolicy, parsePolicy } from "@paystage/policy";
|
|
5
5
|
import { evaluatePayment, normalizePaymentRequired, } from "@paystage/preflight";
|
|
6
6
|
import { listOutstandingAuths, evaluateOutstandingAuths, createRpcClient, resolveRpcUrl, } from "@paystage/auth-watch";
|
|
7
|
+
import { evaluateTrade, parseTradePolicy, fetchMetaAndAssetCtxs, } from "@paystage/trade-preflight";
|
|
8
|
+
import { evaluateVelocity, serializeVelocityResult, EvaluateVelocityInputSchema, } from "@paystage/velocity";
|
|
7
9
|
export const TOOL_NAMES = [
|
|
8
10
|
"evaluate_mcp_payment",
|
|
9
11
|
"list_outstanding_auths",
|
|
10
12
|
"evaluate_outstanding_auths",
|
|
13
|
+
"evaluate_hip3_trade",
|
|
14
|
+
"evaluate_velocity",
|
|
11
15
|
];
|
|
12
16
|
const DEFAULT_NETWORK = "base";
|
|
13
17
|
async function resolvePolicy(input) {
|
|
@@ -35,6 +39,15 @@ const authWatchShape = {
|
|
|
35
39
|
eip3009_nonces: z.array(z.string()).optional(),
|
|
36
40
|
rpc_url: z.string().optional(),
|
|
37
41
|
};
|
|
42
|
+
const tradeProposalShape = z.object({
|
|
43
|
+
dex: z.string(),
|
|
44
|
+
asset: z.string(),
|
|
45
|
+
side: z.enum(["buy", "sell"]),
|
|
46
|
+
size: z.string(),
|
|
47
|
+
leverage: z.number().optional(),
|
|
48
|
+
order_type: z.enum(["limit", "market"]).optional(),
|
|
49
|
+
limit_px: z.string().optional(),
|
|
50
|
+
});
|
|
38
51
|
function registerAllTools(server) {
|
|
39
52
|
server.registerTool("evaluate_mcp_payment", {
|
|
40
53
|
description: "Evaluate an x402 PaymentRequired payload against a PayStage spending policy before paying",
|
|
@@ -118,6 +131,63 @@ function registerAllTools(server) {
|
|
|
118
131
|
],
|
|
119
132
|
};
|
|
120
133
|
});
|
|
134
|
+
server.registerTool("evaluate_hip3_trade", {
|
|
135
|
+
description: "Evaluate a Hyperliquid HIP-3 (trade.xyz) order against a TradePolicy before an agent trades. Returns decision allow | review | do_not_trade.",
|
|
136
|
+
inputSchema: {
|
|
137
|
+
proposal: tradeProposalShape,
|
|
138
|
+
policy: z.unknown().optional(),
|
|
139
|
+
policy_path: z.string().optional(),
|
|
140
|
+
snapshot: z.unknown().optional(),
|
|
141
|
+
},
|
|
142
|
+
}, async (args) => {
|
|
143
|
+
try {
|
|
144
|
+
const policy = parseTradePolicy(args.policy);
|
|
145
|
+
const snapshot = args.snapshot !== undefined
|
|
146
|
+
? args.snapshot
|
|
147
|
+
: await fetchMetaAndAssetCtxs(args.proposal.dex || "xyz");
|
|
148
|
+
const result = evaluateTrade(args.proposal, snapshot, policy);
|
|
149
|
+
return {
|
|
150
|
+
content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
catch (error) {
|
|
154
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
155
|
+
return {
|
|
156
|
+
isError: true,
|
|
157
|
+
content: [{ type: "text", text: `Error: ${message}` }],
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
});
|
|
161
|
+
server.registerTool("evaluate_velocity", {
|
|
162
|
+
description: "Rolling-window rate and spend-pattern check for a proposed payment against recent action history and a policy.velocity config",
|
|
163
|
+
inputSchema: {
|
|
164
|
+
history: EvaluateVelocityInputSchema.shape.history,
|
|
165
|
+
proposed: EvaluateVelocityInputSchema.shape.proposed,
|
|
166
|
+
policy: z.unknown().optional(),
|
|
167
|
+
policy_path: z.string().optional(),
|
|
168
|
+
now_ms: z.number().int().nonnegative().optional(),
|
|
169
|
+
},
|
|
170
|
+
}, async (input) => {
|
|
171
|
+
try {
|
|
172
|
+
const parsed = EvaluateVelocityInputSchema.parse(input);
|
|
173
|
+
const result = await evaluateVelocity(parsed);
|
|
174
|
+
return {
|
|
175
|
+
content: [
|
|
176
|
+
{
|
|
177
|
+
type: "text",
|
|
178
|
+
text: JSON.stringify(serializeVelocityResult(result), null, 2),
|
|
179
|
+
},
|
|
180
|
+
],
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
catch (error) {
|
|
184
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
185
|
+
return {
|
|
186
|
+
isError: true,
|
|
187
|
+
content: [{ type: "text", text: `Error: ${message}` }],
|
|
188
|
+
};
|
|
189
|
+
}
|
|
190
|
+
});
|
|
121
191
|
}
|
|
122
192
|
export function createServer() {
|
|
123
193
|
const server = new McpServer({
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,sBAAsB;IACtB,wBAAwB;IACxB,4BAA4B;IAC5B,qBAAqB;IACrB,mBAAmB;CACX,CAAC;AAIX,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,KAAK,UAAU,aAAa,CAAC,KAG5B;IACC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,GACR,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,eAAe,CAAC;IAC3E,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,OAAe;IACvD,MAAM,MAAM,GAAI,MAAgD,CAAC,MAAM,CAAC;IACxE,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc;IACvC,MAAM,QAAQ,GAAI,MAAkC,CAAC,QAAQ,CAAC;IAC9D,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,cAAc,GAAG;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC;AAaF,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AASH,SAAS,gBAAgB,CAAC,MAAiB;IACzC,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE;YACX,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;YAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC/B;KACF,EACD,KAAK,EAAE,KAIN,EAGE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAmB,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,oDAAoD,EACpD,cAAc,EACd,KAAK,EAAE,IAAmB,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,MAAM;YACN,QAAQ;YACR,GAAG;YACH,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,GAAG,CAAC;YACJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE;SAC5B,CAAC,CAAC,CAAC;QACJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,4BAA4B,EAC5B,qEAAqE,EACrE,cAAc,EACd,KAAK,EAAE,IAAmB,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,MAAM;YACN,QAAQ;YACR,GAAG;YACH,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;YACrD,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;QACJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,8IAA8I;QAChJ,WAAW,EAAE;YACX,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACjC;KACF,EACD,KAAK,EAAE,IAAmB,EAGvB,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,KAAK,SAAS;gBACzB,CAAC,CAAE,IAAI,CAAC,QAAqB;gBAC7B,CAAC,CAAC,MAAM,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAwB,aAAa,CAC/C,IAAI,CAAC,QAAQ,EACb,QAAQ,EACR,MAAM,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,+HAA+H;QACjI,WAAW,EAAE;YACX,OAAO,EAAE,2BAA2B,CAAC,KAAK,CAAC,OAAO;YAClD,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,QAAQ;YACpD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;SAClD;KACF,EACD,KAAK,EAAE,KAMN,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC/D;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@paystage/mcp",
|
|
3
|
-
"version": "0.1
|
|
4
|
-
"description": "PayStage umbrella MCP
|
|
3
|
+
"version": "0.2.1",
|
|
4
|
+
"description": "PayStage umbrella MCP: payment preflight, auth watch, HIP-3 trade preflight, and velocity rate/spend-pattern checks",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"bin": {
|
|
@@ -21,7 +21,9 @@
|
|
|
21
21
|
"agent-payments",
|
|
22
22
|
"usdc",
|
|
23
23
|
"base",
|
|
24
|
-
"paystage"
|
|
24
|
+
"paystage",
|
|
25
|
+
"hip-3",
|
|
26
|
+
"trade"
|
|
25
27
|
],
|
|
26
28
|
"homepage": "https://paystage.xyz",
|
|
27
29
|
"repository": {
|
|
@@ -37,9 +39,11 @@
|
|
|
37
39
|
},
|
|
38
40
|
"dependencies": {
|
|
39
41
|
"@modelcontextprotocol/sdk": "^1.12.0",
|
|
42
|
+
"@paystage/auth-watch": "0.1.0",
|
|
40
43
|
"@paystage/policy": "0.1.0",
|
|
41
44
|
"@paystage/preflight": "0.1.0",
|
|
42
|
-
"@paystage/
|
|
45
|
+
"@paystage/trade-preflight": "^0.1.2",
|
|
46
|
+
"@paystage/velocity": "^0.1.2",
|
|
43
47
|
"zod": "^3.23.8"
|
|
44
48
|
},
|
|
45
49
|
"devDependencies": {
|
package/server.json
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "xyz.paystage/mcp",
|
|
4
4
|
"title": "PayStage",
|
|
5
|
-
"description": "PayStage umbrella
|
|
6
|
-
"version": "0.1
|
|
5
|
+
"description": "PayStage umbrella: payment preflight, auth watch, HIP-3 trade preflight, and velocity rate/spend-pattern checks",
|
|
6
|
+
"version": "0.2.1",
|
|
7
7
|
"websiteUrl": "https://paystage.xyz",
|
|
8
8
|
"repository": {
|
|
9
9
|
"url": "https://github.com/base-buzz/paystage",
|
|
@@ -13,20 +13,21 @@
|
|
|
13
13
|
"packages": [
|
|
14
14
|
{
|
|
15
15
|
"registryType": "npm",
|
|
16
|
+
"registryBaseUrl": "https://registry.npmjs.org",
|
|
16
17
|
"identifier": "@paystage/mcp",
|
|
17
|
-
"version": "0.1
|
|
18
|
+
"version": "0.2.1",
|
|
18
19
|
"transport": {
|
|
19
20
|
"type": "stdio"
|
|
20
21
|
},
|
|
21
22
|
"environmentVariables": [
|
|
22
23
|
{
|
|
23
24
|
"name": "PAYSTAGE_POLICY_PATH",
|
|
24
|
-
"description": "Path to
|
|
25
|
+
"description": "Path to policy.json spending rules",
|
|
25
26
|
"isRequired": false
|
|
26
27
|
},
|
|
27
28
|
{
|
|
28
29
|
"name": "PAYSTAGE_RPC_URL",
|
|
29
|
-
"description": "RPC URL
|
|
30
|
+
"description": "Base RPC URL override",
|
|
30
31
|
"isRequired": false
|
|
31
32
|
}
|
|
32
33
|
]
|