@paystage/mcp 0.0.0-stage → 0.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
@@ -1,3 +1,91 @@
1
- # Temporary Holding Version
1
+ # @paystage/mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ PayStage umbrella MCP server: payment preflight, auth watch, and HIP-3 trade preflight.
4
+
5
+ > Not financial advice. The trade preflight tool is a local policy gate only — it does not
6
+ > place orders or recommend trades.
7
+
8
+ Published on npm as **`@paystage/mcp@0.2.0`**.
9
+
10
+ ## Install
11
+
12
+ ```sh
13
+ npx -y @paystage/mcp
14
+ ```
15
+
16
+ Or:
17
+
18
+ ```sh
19
+ npm install @paystage/mcp
20
+ ```
21
+
22
+ The package exposes a `stdio` MCP server (bin: `paystage-mcp`).
23
+
24
+ ## MCP configuration
25
+
26
+ ```json
27
+ {
28
+ "mcpServers": {
29
+ "paystage": {
30
+ "command": "npx",
31
+ "args": ["-y", "@paystage/mcp"],
32
+ "env": {
33
+ "PAYSTAGE_POLICY_PATH": "./policy.json"
34
+ }
35
+ }
36
+ }
37
+ }
38
+ ```
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
+
89
+ ## License
90
+
91
+ MIT
package/dist/cli.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
package/dist/cli.js ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+ import { startServer } from "./server.js";
3
+ startServer().catch((error) => {
4
+ const message = error instanceof Error ? error.message : String(error);
5
+ process.stderr.write(`paystage-mcp fatal: ${message}\n`);
6
+ process.exit(1);
7
+ });
8
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { createServer, startServer, getToolNames, TOOL_NAMES } from "./server.js";
2
+ export type { ToolName } from "./server.js";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,2 @@
1
+ export { createServer, startServer, getToolNames, TOOL_NAMES } from "./server.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,7 @@
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", "evaluate_hip3_trade"];
3
+ export type ToolName = (typeof TOOL_NAMES)[number];
4
+ export declare function createServer(): McpServer;
5
+ export declare function getToolNames(): string[];
6
+ export declare function startServer(): Promise<void>;
7
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BpE,eAAO,MAAM,UAAU,kHAKb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAqNnD,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 ADDED
@@ -0,0 +1,176 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
+ import { z } from "zod";
4
+ import { loadPolicy, parsePolicy } from "@paystage/policy";
5
+ import { evaluatePayment, normalizePaymentRequired, } from "@paystage/preflight";
6
+ import { listOutstandingAuths, evaluateOutstandingAuths, createRpcClient, resolveRpcUrl, } from "@paystage/auth-watch";
7
+ import { evaluateTrade, parseTradePolicy, fetchMetaAndAssetCtxs, } from "@paystage/trade-preflight";
8
+ export const TOOL_NAMES = [
9
+ "evaluate_mcp_payment",
10
+ "list_outstanding_auths",
11
+ "evaluate_outstanding_auths",
12
+ "evaluate_hip3_trade",
13
+ ];
14
+ const DEFAULT_NETWORK = "base";
15
+ async function resolvePolicy(input) {
16
+ if (input.policy !== undefined) {
17
+ return parsePolicy(input.policy);
18
+ }
19
+ const path = input.policy_path ?? process.env.PAYSTAGE_POLICY_PATH ?? "./policy.json";
20
+ return await loadPolicy(path);
21
+ }
22
+ function tokensForNetwork(policy, network) {
23
+ const tokens = policy.tokens;
24
+ return tokens?.[network] ?? [];
25
+ }
26
+ function spendersForPolicy(policy) {
27
+ const spenders = policy.spenders;
28
+ return spenders ?? [];
29
+ }
30
+ const authWatchShape = {
31
+ wallet: z.string(),
32
+ network: z.string().optional(),
33
+ tokens: z.array(z.string()).optional(),
34
+ spenders: z.array(z.string()).optional(),
35
+ policy_path: z.string().optional(),
36
+ policy: z.unknown().optional(),
37
+ eip3009_nonces: z.array(z.string()).optional(),
38
+ rpc_url: z.string().optional(),
39
+ };
40
+ const tradeProposalShape = z.object({
41
+ dex: z.string(),
42
+ asset: z.string(),
43
+ side: z.enum(["buy", "sell"]),
44
+ size: z.string(),
45
+ leverage: z.number().optional(),
46
+ order_type: z.enum(["limit", "market"]).optional(),
47
+ limit_px: z.string().optional(),
48
+ });
49
+ function registerAllTools(server) {
50
+ server.registerTool("evaluate_mcp_payment", {
51
+ description: "Evaluate an x402 PaymentRequired payload against a PayStage spending policy before paying",
52
+ inputSchema: {
53
+ payment_required: z.unknown(),
54
+ policy_path: z.string().optional(),
55
+ policy: z.unknown().optional(),
56
+ },
57
+ }, async (input) => {
58
+ try {
59
+ const policy = await resolvePolicy(input);
60
+ const pr = normalizePaymentRequired(input.payment_required);
61
+ const result = evaluatePayment(pr, policy);
62
+ return {
63
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
64
+ };
65
+ }
66
+ catch (error) {
67
+ const message = error instanceof Error ? error.message : String(error);
68
+ return {
69
+ isError: true,
70
+ content: [{ type: "text", text: `Error: ${message}` }],
71
+ };
72
+ }
73
+ });
74
+ server.tool("list_outstanding_auths", "List outstanding token authorizations for a wallet", authWatchShape, async (args) => {
75
+ const policy = await resolvePolicy(args);
76
+ const network = args.network ?? DEFAULT_NETWORK;
77
+ const tokens = args.tokens ?? tokensForNetwork(policy, network);
78
+ const spenders = args.spenders ?? spendersForPolicy(policy);
79
+ const rpcUrl = args.rpc_url ?? resolveRpcUrl(network);
80
+ const rpc = createRpcClient(rpcUrl);
81
+ const items = await listOutstandingAuths({
82
+ wallet: args.wallet,
83
+ network,
84
+ tokens,
85
+ spenders,
86
+ rpc,
87
+ eip3009Nonces: args.eip3009_nonces,
88
+ });
89
+ const serialized = items.map((i) => ({
90
+ ...i,
91
+ amount: i.amount.toString(),
92
+ }));
93
+ return {
94
+ content: [
95
+ {
96
+ type: "text",
97
+ text: JSON.stringify({ items: serialized }, null, 2),
98
+ },
99
+ ],
100
+ };
101
+ });
102
+ server.tool("evaluate_outstanding_auths", "List and evaluate outstanding token authorizations against a policy", authWatchShape, async (args) => {
103
+ const policy = await resolvePolicy(args);
104
+ const network = args.network ?? DEFAULT_NETWORK;
105
+ const tokens = args.tokens ?? tokensForNetwork(policy, network);
106
+ const spenders = args.spenders ?? spendersForPolicy(policy);
107
+ const rpcUrl = args.rpc_url ?? resolveRpcUrl(network);
108
+ const rpc = createRpcClient(rpcUrl);
109
+ const items = await listOutstandingAuths({
110
+ wallet: args.wallet,
111
+ network,
112
+ tokens,
113
+ spenders,
114
+ rpc,
115
+ eip3009Nonces: args.eip3009_nonces,
116
+ });
117
+ const results = evaluateOutstandingAuths(items, policy);
118
+ const serialized = results.map((r) => ({
119
+ item: { ...r.item, amount: r.item.amount.toString() },
120
+ flags: r.flags,
121
+ summary: r.summary,
122
+ }));
123
+ return {
124
+ content: [
125
+ {
126
+ type: "text",
127
+ text: JSON.stringify({ results: serialized }, null, 2),
128
+ },
129
+ ],
130
+ };
131
+ });
132
+ server.registerTool("evaluate_hip3_trade", {
133
+ description: "Evaluate a Hyperliquid HIP-3 (trade.xyz) order against a TradePolicy before an agent trades. Returns decision allow | review | do_not_trade.",
134
+ inputSchema: {
135
+ proposal: tradeProposalShape,
136
+ policy: z.unknown().optional(),
137
+ policy_path: z.string().optional(),
138
+ snapshot: z.unknown().optional(),
139
+ },
140
+ }, async (args) => {
141
+ try {
142
+ const policy = parseTradePolicy(args.policy);
143
+ const snapshot = args.snapshot !== undefined
144
+ ? args.snapshot
145
+ : await fetchMetaAndAssetCtxs(args.proposal.dex || "xyz");
146
+ const result = evaluateTrade(args.proposal, snapshot, policy);
147
+ return {
148
+ content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
149
+ };
150
+ }
151
+ catch (error) {
152
+ const message = error instanceof Error ? error.message : String(error);
153
+ return {
154
+ isError: true,
155
+ content: [{ type: "text", text: `Error: ${message}` }],
156
+ };
157
+ }
158
+ });
159
+ }
160
+ export function createServer() {
161
+ const server = new McpServer({
162
+ name: "paystage",
163
+ version: "0.1.0",
164
+ });
165
+ registerAllTools(server);
166
+ return server;
167
+ }
168
+ export function getToolNames() {
169
+ return [...TOOL_NAMES];
170
+ }
171
+ export async function startServer() {
172
+ const server = createServer();
173
+ const transport = new StdioServerTransport();
174
+ await server.connect(transport);
175
+ }
176
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,59 @@
1
1
  {
2
2
  "name": "@paystage/mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.2.0",
4
+ "description": "PayStage umbrella MCP: payment preflight, auth watch, and HIP-3 trade preflight",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "bin": {
8
+ "paystage-mcp": "./dist/cli.js"
9
+ },
10
+ "files": [
11
+ "dist",
12
+ "server.json"
13
+ ],
14
+ "mcpName": "xyz.paystage/mcp",
15
+ "engines": {
16
+ "node": ">=20"
17
+ },
18
+ "keywords": [
19
+ "mcp",
20
+ "x402",
21
+ "agent-payments",
22
+ "usdc",
23
+ "base",
24
+ "paystage",
25
+ "hip-3",
26
+ "trade"
27
+ ],
28
+ "homepage": "https://paystage.xyz",
29
+ "repository": {
30
+ "type": "git",
31
+ "url": "git+https://github.com/base-buzz/paystage.git",
32
+ "directory": "packages/mcp"
33
+ },
34
+ "bugs": {
35
+ "url": "https://github.com/base-buzz/paystage/issues"
36
+ },
37
+ "publishConfig": {
38
+ "access": "public"
39
+ },
40
+ "dependencies": {
41
+ "@modelcontextprotocol/sdk": "^1.12.0",
42
+ "@paystage/policy": "0.1.0",
43
+ "@paystage/preflight": "0.1.0",
44
+ "@paystage/auth-watch": "0.1.0",
45
+ "@paystage/trade-preflight": "^0.1.2",
46
+ "zod": "^3.23.8"
47
+ },
48
+ "devDependencies": {
49
+ "@types/node": "^20.14.0",
50
+ "typescript": "^5.5.4",
51
+ "vitest": "^2.0.5"
52
+ },
53
+ "scripts": {
54
+ "build": "tsc",
55
+ "test": "vitest run",
56
+ "typecheck": "tsc --noEmit",
57
+ "prepublishOnly": "npm run build"
58
+ }
59
+ }
package/server.json ADDED
@@ -0,0 +1,36 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "xyz.paystage/mcp",
4
+ "title": "PayStage",
5
+ "description": "PayStage umbrella: payment preflight, auth watch, and HIP-3 trade preflight",
6
+ "version": "0.2.0",
7
+ "websiteUrl": "https://paystage.xyz",
8
+ "repository": {
9
+ "url": "https://github.com/base-buzz/paystage",
10
+ "source": "github",
11
+ "subfolder": "packages/mcp"
12
+ },
13
+ "packages": [
14
+ {
15
+ "registryType": "npm",
16
+ "registryBaseUrl": "https://registry.npmjs.org",
17
+ "identifier": "@paystage/mcp",
18
+ "version": "0.2.0",
19
+ "transport": {
20
+ "type": "stdio"
21
+ },
22
+ "environmentVariables": [
23
+ {
24
+ "name": "PAYSTAGE_POLICY_PATH",
25
+ "description": "Path to policy.json spending rules",
26
+ "isRequired": false
27
+ },
28
+ {
29
+ "name": "PAYSTAGE_RPC_URL",
30
+ "description": "Base RPC URL override",
31
+ "isRequired": false
32
+ }
33
+ ]
34
+ }
35
+ ]
36
+ }