@xrpl-utilities/mcp 0.1.6 → 0.1.7
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/dist/dispatch.js +2 -2
- package/dist/dispatch.js.map +1 -1
- package/dist/server.js +1 -1
- package/dist/transport/http.js +109 -3
- package/dist/transport/http.js.map +1 -1
- package/dist/transport/stdio.js +1 -1
- package/package.json +1 -1
package/dist/dispatch.js
CHANGED
|
@@ -74,7 +74,7 @@ export async function dispatchTool(toolName, args, opts = {}) {
|
|
|
74
74
|
// service as its dev-bypass header).
|
|
75
75
|
const headers = {
|
|
76
76
|
Accept: "application/json",
|
|
77
|
-
"User-Agent": opts.userAgent ?? "xrpl-utilities-mcp/0.1.
|
|
77
|
+
"User-Agent": opts.userAgent ?? "xrpl-utilities-mcp/0.1.7",
|
|
78
78
|
};
|
|
79
79
|
const callerPaymentSig = stringArg(args.payment_signature);
|
|
80
80
|
const callerBypassKey = stringArg(args._bypass_key);
|
|
@@ -84,7 +84,7 @@ export async function dispatchTool(toolName, args, opts = {}) {
|
|
|
84
84
|
}
|
|
85
85
|
else if (callerBypassKey && opts.bypassKey && callerBypassKey === opts.bypassKey) {
|
|
86
86
|
// Operator-issued bypass. Forward as the dev-bypass header that
|
|
87
|
-
// the underlying services accept
|
|
87
|
+
// the underlying services accept.
|
|
88
88
|
headers["PAYMENT-SIGNATURE"] = callerBypassKey;
|
|
89
89
|
}
|
|
90
90
|
else {
|
package/dist/dispatch.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmBpD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,IAA6B,EAC7B,OAAwB,EAAE;IAE1B,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC;IAEtE,+DAA+D;IAC/D,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACrB,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACtE,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,QAAQ,QAAQ,4BAA4B,GAAG,qBAAqB,CACrE,CAAC;QACJ,CAAC;QACD,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,sEAAsE;IACtE,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS;QAC/B,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;QACzB,aAAa;QACb,mBAAmB;KACpB,CAAC,CAAC;IACH,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAC9B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,kEAAkE;IAClE,mEAAmE;IACnE,oEAAoE;IACpE,qCAAqC;IACrC,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,kBAAkB;QAC1B,YAAY,EAAE,IAAI,CAAC,SAAS,IAAI,0BAA0B;KAC3D,CAAC;IAEF,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACpC,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,CAAC;QAClD,CAAC;aAAM,IAAI,eAAe,IAAI,IAAI,CAAC,SAAS,IAAI,eAAe,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACnF,gEAAgE;YAChE,
|
|
1
|
+
{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -9,7 +9,7 @@ import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSche
|
|
|
9
9
|
import { ALL_TOOLS, SERVICES } from "./services/index.js";
|
|
10
10
|
import { dispatchTool } from "./dispatch.js";
|
|
11
11
|
const SERVER_NAME = "xrpl-utilities";
|
|
12
|
-
const SERVER_VERSION = "0.1.
|
|
12
|
+
const SERVER_VERSION = "0.1.7";
|
|
13
13
|
export function buildServer(opts = {}) {
|
|
14
14
|
const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {}, resources: {} } });
|
|
15
15
|
// ---- Tools ---------------------------------------------------------------
|
package/dist/transport/http.js
CHANGED
|
@@ -18,6 +18,8 @@
|
|
|
18
18
|
import express from "express";
|
|
19
19
|
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
|
|
20
20
|
import { buildServer } from "../server.js";
|
|
21
|
+
import { SERVICES, ALL_TOOLS } from "../services/index.js";
|
|
22
|
+
const SERVER_VERSION = "0.1.7";
|
|
21
23
|
const RATE_WINDOW_MS = 60_000;
|
|
22
24
|
const RATE_LIMIT_PER_WINDOW = 60; // generous; agents typically fire bursts
|
|
23
25
|
const rateBuckets = new Map();
|
|
@@ -46,14 +48,118 @@ export async function runHttp(port) {
|
|
|
46
48
|
res.json({
|
|
47
49
|
service: "xrpl-utilities-mcp",
|
|
48
50
|
description: "MCP server for the XRPL-Utilities portfolio (Sentinel, Pulse, Telemetry, Trust). Connect any MCP client to /mcp.",
|
|
49
|
-
version:
|
|
51
|
+
version: SERVER_VERSION,
|
|
50
52
|
mcp_endpoint: "/mcp",
|
|
53
|
+
manifest: "/agents.json",
|
|
54
|
+
well_known_manifest: "/.well-known/agents.json",
|
|
55
|
+
llms_discovery: "/llms.txt",
|
|
51
56
|
docs: "https://github.com/XRPL-Utilities/xrpl-utilities-mcp",
|
|
52
57
|
portfolio: "https://xrpl-utilities.com",
|
|
53
58
|
});
|
|
54
59
|
});
|
|
55
60
|
app.get("/healthz", async (_req, res) => {
|
|
56
|
-
res.json({ status: "ok", service: "xrpl-utilities-mcp", version:
|
|
61
|
+
res.json({ status: "ok", service: "xrpl-utilities-mcp", version: SERVER_VERSION });
|
|
62
|
+
});
|
|
63
|
+
// ---- Discovery surfaces for non-MCP-speaking crawlers ----
|
|
64
|
+
// The /mcp endpoint speaks JSON-RPC (POST + SSE) and is invisible
|
|
65
|
+
// to a regular HTTP crawler. These routes give an LLM crawler or
|
|
66
|
+
// search engine something to chew on so the MCP server isn't a
|
|
67
|
+
// discoverability black hole.
|
|
68
|
+
const manifest = () => ({
|
|
69
|
+
schema_version: SERVER_VERSION,
|
|
70
|
+
name: "XRPL-Utilities MCP",
|
|
71
|
+
provider: "XRPL-Utilities™",
|
|
72
|
+
description: "Model Context Protocol server exposing the XRPL-Utilities portfolio " +
|
|
73
|
+
"(Sentinel, Pulse, Telemetry, Trust) as " + ALL_TOOLS.length + " callable tools " +
|
|
74
|
+
"for AI agents. Stateless passthrough proxy: callers supply their own " +
|
|
75
|
+
"x402 v2 payment header per tool call. Settled inline via the t54 " +
|
|
76
|
+
"facilitator on XRPL mainnet; $0.10 USD per paid call lands on the " +
|
|
77
|
+
"operator treasury wallet. The MCP server holds no wallets and takes no cut.",
|
|
78
|
+
service_status: "live",
|
|
79
|
+
endpoints: {
|
|
80
|
+
base_url: "https://mcp.xrpl-utilities.io",
|
|
81
|
+
mcp: "/mcp",
|
|
82
|
+
discovery: "/llms.txt",
|
|
83
|
+
manifest: "/agents.json",
|
|
84
|
+
well_known_manifest: "/.well-known/agents.json",
|
|
85
|
+
health: "/healthz",
|
|
86
|
+
},
|
|
87
|
+
transports: ["stdio", "streamable-http"],
|
|
88
|
+
tool_count: ALL_TOOLS.length,
|
|
89
|
+
tools: ALL_TOOLS.map((t) => ({
|
|
90
|
+
name: t.name,
|
|
91
|
+
description: t.description,
|
|
92
|
+
auth_mode: t.authMode,
|
|
93
|
+
})),
|
|
94
|
+
underlying_services: SERVICES.map((s) => ({
|
|
95
|
+
id: s.id,
|
|
96
|
+
label: s.label,
|
|
97
|
+
base_url: s.baseUrl,
|
|
98
|
+
manifest_url: s.manifestUrl,
|
|
99
|
+
})),
|
|
100
|
+
homepage: "https://xrpl-utilities.com",
|
|
101
|
+
repository: "https://github.com/XRPL-Utilities/xrpl-utilities-mcp",
|
|
102
|
+
npm: "https://www.npmjs.com/package/@xrpl-utilities/mcp",
|
|
103
|
+
license: "MIT",
|
|
104
|
+
});
|
|
105
|
+
app.get("/agents.json", (_req, res) => res.json(manifest()));
|
|
106
|
+
app.get("/.well-known/agents.json", (_req, res) => res.json(manifest()));
|
|
107
|
+
app.get("/llms.txt", (_req, res) => {
|
|
108
|
+
const toolList = ALL_TOOLS.map((t) => `- \`${t.name}\` [${t.authMode}]`).join("\n");
|
|
109
|
+
const body = [
|
|
110
|
+
"# XRPL-Utilities MCP™",
|
|
111
|
+
"",
|
|
112
|
+
"Model Context Protocol server exposing the XRPL-Utilities portfolio",
|
|
113
|
+
`(Sentinel, Pulse, Telemetry, Trust) as ${ALL_TOOLS.length} callable tools for AI agents.`,
|
|
114
|
+
"Stateless passthrough proxy.",
|
|
115
|
+
"Provider: XRPL-Utilities™ LLC.",
|
|
116
|
+
"",
|
|
117
|
+
"## Connect",
|
|
118
|
+
"- Hosted (any MCP client, including Claude Desktop with HTTP support):",
|
|
119
|
+
" POST JSON-RPC + SSE to `https://mcp.xrpl-utilities.io/mcp`",
|
|
120
|
+
"- Local (Claude Desktop config):",
|
|
121
|
+
" ```",
|
|
122
|
+
" npm i @xrpl-utilities/mcp",
|
|
123
|
+
" npx @xrpl-utilities/mcp --transport stdio",
|
|
124
|
+
" ```",
|
|
125
|
+
"",
|
|
126
|
+
"## Tools",
|
|
127
|
+
toolList,
|
|
128
|
+
"",
|
|
129
|
+
"## Auth model",
|
|
130
|
+
"Each `inline_x402` tool requires the caller to pass `payment_signature` in",
|
|
131
|
+
"tool args - a base64-JSON-encoded x402 v2 payment header signing an XRPL",
|
|
132
|
+
"Payment that matches one of the requirements returned by an unauthenticated",
|
|
133
|
+
"probe. The MCP server forwards it as the `PAYMENT-SIGNATURE` header on the",
|
|
134
|
+
"underlying call. $0.10 USD per call (XRP or RLUSD), settled inline via the",
|
|
135
|
+
"t54 facilitator. The `async_invoice` tools (Telemetry quote/status/results)",
|
|
136
|
+
"use an out-of-band XRPL Payment to a deeplink instead of an inline header.",
|
|
137
|
+
"",
|
|
138
|
+
"## Discovery",
|
|
139
|
+
"- Manifest: https://mcp.xrpl-utilities.io/agents.json",
|
|
140
|
+
"- Source: https://github.com/XRPL-Utilities/xrpl-utilities-mcp",
|
|
141
|
+
"- npm package: https://www.npmjs.com/package/@xrpl-utilities/mcp",
|
|
142
|
+
"- Portfolio: https://xrpl-utilities.com",
|
|
143
|
+
"",
|
|
144
|
+
"## What this is NOT",
|
|
145
|
+
"Not a wallet. Not a custodian. Not an editorial product. Not investment",
|
|
146
|
+
"advice. The MCP server holds no wallets and takes no cut - same x402",
|
|
147
|
+
"settlement model as direct API calls, just wrapped as MCP tools so AI",
|
|
148
|
+
"agents can discover and use them via tool-completion.",
|
|
149
|
+
"",
|
|
150
|
+
].join("\n");
|
|
151
|
+
res.type("text/markdown; charset=utf-8").send(body);
|
|
152
|
+
});
|
|
153
|
+
app.get("/robots.txt", (_req, res) => {
|
|
154
|
+
const body = [
|
|
155
|
+
"# xrpl-utilities-mcp is built to be discovered by AI agents and crawlers.",
|
|
156
|
+
"# Machine-readable manifests: /agents.json, /.well-known/agents.json, /llms.txt",
|
|
157
|
+
"# MCP JSON-RPC endpoint: /mcp",
|
|
158
|
+
"User-agent: *",
|
|
159
|
+
"Allow: /",
|
|
160
|
+
"",
|
|
161
|
+
].join("\n");
|
|
162
|
+
res.type("text/plain; charset=utf-8").send(body);
|
|
57
163
|
});
|
|
58
164
|
// Stateless mode: each /mcp request gets a fresh Server + Transport
|
|
59
165
|
// pair. The MCP SDK's streamable-http transport, even with
|
|
@@ -70,7 +176,7 @@ export async function runHttp(port) {
|
|
|
70
176
|
try {
|
|
71
177
|
const mcpServer = buildServer({
|
|
72
178
|
bypassKey: process.env["MCP_BYPASS_KEY"],
|
|
73
|
-
userAgent: `xrpl-utilities-mcp
|
|
179
|
+
userAgent: `xrpl-utilities-mcp/${SERVER_VERSION} (http)`,
|
|
74
180
|
});
|
|
75
181
|
transport = new StreamableHTTPServerTransport({
|
|
76
182
|
sessionIdGenerator: undefined, // stateless
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,OAAwC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,OAAwC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,qBAAqB,GAAG,EAAE,CAAC,CAAC,yCAAyC;AAM3E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;AAElD,SAAS,SAAS,CAAC,GAAY,EAAE,GAAa;IAC5C,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC;SACjF,QAAQ,EAAE;SACV,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE;SACd,IAAI,EAAE,CAAC;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;QACpC,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,CAAC;QACrD,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IAClB,IAAI,MAAM,CAAC,KAAK,GAAG,qBAAqB,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACzG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAExC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACzB,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,oBAAoB;YAC7B,WAAW,EACT,kHAAkH;YACpH,OAAO,EAAE,cAAc;YACvB,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,cAAc;YACxB,mBAAmB,EAAE,0BAA0B;YAC/C,cAAc,EAAE,WAAW;YAC3B,IAAI,EAAE,sDAAsD;YAC5D,SAAS,EAAE,4BAA4B;SACxC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,kEAAkE;IAClE,iEAAiE;IACjE,+DAA+D;IAC/D,8BAA8B;IAE9B,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;QACtB,cAAc,EAAE,cAAc;QAC9B,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,WAAW,EACT,sEAAsE;YACtE,yCAAyC,GAAG,SAAS,CAAC,MAAM,GAAG,kBAAkB;YACjF,uEAAuE;YACvE,mEAAmE;YACnE,oEAAoE;YACpE,6EAA6E;QAC/E,cAAc,EAAE,MAAM;QACtB,SAAS,EAAE;YACT,QAAQ,EAAE,+BAA+B;YACzC,GAAG,EAAE,MAAM;YACX,SAAS,EAAE,WAAW;YACtB,QAAQ,EAAE,cAAc;YACxB,mBAAmB,EAAE,0BAA0B;YAC/C,MAAM,EAAE,UAAU;SACnB;QACD,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACxC,UAAU,EAAE,SAAS,CAAC,MAAM;QAC5B,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,QAAQ;SACtB,CAAC,CAAC;QACH,mBAAmB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,OAAO;YACnB,YAAY,EAAE,CAAC,CAAC,WAAW;SAC5B,CAAC,CAAC;QACH,QAAQ,EAAE,4BAA4B;QACtC,UAAU,EAAE,sDAAsD;QAClE,GAAG,EAAE,mDAAmD;QACxD,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC7D,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEzE,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,QAAQ,GAAG,CAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,IAAI,GAAG;YACX,uBAAuB;YACvB,EAAE;YACF,qEAAqE;YACrE,0CAA0C,SAAS,CAAC,MAAM,gCAAgC;YAC1F,8BAA8B;YAC9B,gCAAgC;YAChC,EAAE;YACF,YAAY;YACZ,wEAAwE;YACxE,8DAA8D;YAC9D,kCAAkC;YAClC,OAAO;YACP,6BAA6B;YAC7B,6CAA6C;YAC7C,OAAO;YACP,EAAE;YACF,UAAU;YACV,QAAQ;YACR,EAAE;YACF,eAAe;YACf,4EAA4E;YAC5E,0EAA0E;YAC1E,6EAA6E;YAC7E,4EAA4E;YAC5E,4EAA4E;YAC5E,6EAA6E;YAC7E,4EAA4E;YAC5E,EAAE;YACF,cAAc;YACd,0DAA0D;YAC1D,qEAAqE;YACrE,kEAAkE;YAClE,2CAA2C;YAC3C,EAAE;YACF,qBAAqB;YACrB,yEAAyE;YACzE,sEAAsE;YACtE,uEAAuE;YACvE,uDAAuD;YACvD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG;YACX,2EAA2E;YAC3E,iFAAiF;YACjF,+BAA+B;YAC/B,eAAe;YACf,UAAU;YACV,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,2DAA2D;IAC3D,kEAAkE;IAClE,qEAAqE;IACrE,mEAAmE;IACnE,kEAAkE;IAClE,mEAAmE;IACnE,iDAAiD;IACjD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO;QACjC,IAAI,SAAS,GAAyC,IAAI,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,WAAW,CAAC;gBAC5B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACxC,SAAS,EAAE,sBAAsB,cAAc,SAAS;aACzD,CAAC,CAAC;YACH,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAC5C,kBAAkB,EAAE,SAAS,EAAE,YAAY;aAC5C,CAAC,CAAC;YACH,iEAAiE;YACjE,8DAA8D;YAC9D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,SAAS,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAG,CAAW,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,SAAS,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC"}
|
package/dist/transport/stdio.js
CHANGED
|
@@ -19,7 +19,7 @@ import { buildServer } from "../server.js";
|
|
|
19
19
|
export async function runStdio() {
|
|
20
20
|
const server = buildServer({
|
|
21
21
|
bypassKey: process.env["MCP_BYPASS_KEY"],
|
|
22
|
-
userAgent: `xrpl-utilities-mcp/0.1.
|
|
22
|
+
userAgent: `xrpl-utilities-mcp/0.1.7 (stdio)`,
|
|
23
23
|
});
|
|
24
24
|
const transport = new StdioServerTransport();
|
|
25
25
|
await server.connect(transport);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xrpl-utilities/mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.7",
|
|
4
4
|
"description": "Model Context Protocol server for the XRPL-Utilities portfolio: Sentinel (wallet classifier), Pulse (signal feed), Telemetry (supply + utility floor), and Trust (XLS-70/80/81 directory). Exposes each service's read endpoints as MCP tools so AI agents can discover and use them via stdio (Claude Desktop) or HTTP/SSE (hosted at mcp.xrpl-utilities.io). Stateless passthrough — caller provides their own x402 payment header.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|