pion-mcp 0.0.1 → 0.1.0

package/README.md

@@ -1,21 +1,84 @@
 # Pion
 
 **Model Context Protocol server for Pi Network** — connect AI agents
-(Claude, Cursor, and any MCP-compatible client) to the Pi Network SDK.
+(Claude, Cursor, and any MCP-compatible client) to Pi Network chain data.
 
-> ⚠️ Early development. Not yet functional. Testnet only.
+> ⚠️ v0.1 — testnet, read-only.
 
 ## Why "Pion"?
 The pion is the π meson — the particle physicists named after pi.
 Fittingly, particle physicists study pion interactions to search
 for MCPs (millicharged particles). We couldn't resist.
 
-## Planned tools
-- `get_wallet_balance` — read-only wallet queries
-- `create_payment_request` — Pi payment flows for agents
-- `query_transaction` — chain data lookup
+## Tools
 
-## Status
-Working. Watch/star to follow along.
+All three are zero-permission reads against Pi's public Horizon API
+(Tier A in [`docs/tool-mapping.md`](docs/tool-mapping.md)). **No API keys, no
+wallet secrets, no user consent** — and nothing here can move value.
+
+| Tool | What it does |
+|---|---|
+| `get_wallet_balance` | Pi and custom-token balances for a wallet address |
+| `get_account_payments` | Paginated payment history for an address |
+| `query_transaction` | Verify a single transaction by hash |
+
+Amounts are decimal strings. Pi is reported as the asset `PI`, custom tokens as
+`CODE:ISSUER`, and liquidity-pool shares as `pool:ID`.
+
+## Usage
+
+MCP clients can run it straight from npm — no install step:
+
+```jsonc
+// Claude Desktop: claude_desktop_config.json
+{
+  "mcpServers": {
+    "pion": {
+      "command": "npx",
+      "args": ["-y", "pion-mcp"]
+    }
+  }
+}
+```
+
+```sh
+# Claude Code
+claude mcp add pion -- npx -y pion-mcp
+```
+
+Or run it from a clone:
+
+```sh
+npm install
+npm run build
+claude mcp add pion -- node /absolute/path/to/pion-mcp/dist/index.js
+```
+
+### Configuration
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `PION_HORIZON_URL` | `https://api.testnet.minepi.com` | Horizon base URL |
+
+There are no secrets to configure. The mainnet Horizon URL is still an open
+question — see the TODO in [`docs/pi-sdk-notes.md`](docs/pi-sdk-notes.md).
+
+## Development
+
+```sh
+npm run build      # compile src/ -> dist/
+npm run typecheck  # types only, no emit
+npm run smoke      # end-to-end: drives the built server against live testnet
+```
+
+`npm run smoke` spawns the server over stdio as a real MCP client, discovers a
+funded account from the current ledger, and exercises all three tools plus the
+not-found and invalid-input paths. It needs network access.
+
+## Roadmap
+
+v0.2 adds Tier B/C behind env config (`PI_SERVER_API_KEY`, `PI_WALLET_SECRET`):
+user verification and App-to-User payments, testnet-default with explicit
+opt-in for anything that moves value. See [`docs/tool-mapping.md`](docs/tool-mapping.md).
 
 *Unofficial community project — not affiliated with Pi Network.*

package/dist/horizon.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Minimal read-only client for Pi's Horizon (Stellar) API.
+ *
+ * Every endpoint used here is public and unauthenticated — no API key, no
+ * bearer token, no wallet secret. See docs/pi-sdk-notes.md, "Layer 3".
+ */
+/** Horizon base URL. Defaults to Pi testnet; override with PION_HORIZON_URL. */
+export declare const HORIZON_URL: string;
+/** A Horizon request that failed — network, timeout, or non-2xx response. */
+export declare class HorizonError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+type QueryParams = Record<string, string | number | undefined>;
+export declare function horizonGet<T>(path: string, params?: QueryParams): Promise<T>;
+/** Renders a Horizon asset triplet as "PI" or "CODE:ISSUER". */
+export declare function formatAsset(assetType: string | undefined, code: string | undefined, issuer: string | undefined): string;
+/** Extracts Horizon's paging cursor from a `_links.next.href` value. */
+export declare function cursorFromLink(href: string | undefined): string | undefined;
+export {};

package/dist/horizon.js

@@ -0,0 +1,82 @@
+/**
+ * Minimal read-only client for Pi's Horizon (Stellar) API.
+ *
+ * Every endpoint used here is public and unauthenticated — no API key, no
+ * bearer token, no wallet secret. See docs/pi-sdk-notes.md, "Layer 3".
+ */
+const DEFAULT_HORIZON_URL = "https://api.testnet.minepi.com";
+const REQUEST_TIMEOUT_MS = 15_000;
+/** Horizon base URL. Defaults to Pi testnet; override with PION_HORIZON_URL. */
+export const HORIZON_URL = (process.env.PION_HORIZON_URL ?? DEFAULT_HORIZON_URL).replace(/\/+$/, "");
+/** A Horizon request that failed — network, timeout, or non-2xx response. */
+export class HorizonError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "HorizonError";
+    }
+}
+export async function horizonGet(path, params) {
+    const url = new URL(HORIZON_URL + path);
+    for (const [key, value] of Object.entries(params ?? {})) {
+        if (value !== undefined)
+            url.searchParams.set(key, String(value));
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(url, {
+            headers: { accept: "application/json" },
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        if (controller.signal.aborted) {
+            throw new HorizonError(`Horizon request timed out after ${REQUEST_TIMEOUT_MS}ms: ${path}`);
+        }
+        throw new HorizonError(`Could not reach Horizon at ${HORIZON_URL}: ${err.message}`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        throw new HorizonError(await describeFailure(response, path), response.status);
+    }
+    return (await response.json());
+}
+async function describeFailure(response, path) {
+    let problem = {};
+    try {
+        problem = (await response.json());
+    }
+    catch {
+        // Non-JSON error body — fall through to the generic message.
+    }
+    if (response.status === 404) {
+        return `Not found on Horizon (${HORIZON_URL}${path}). The account or transaction does not exist on this network, or has never been funded.`;
+    }
+    const parts = [problem.title, problem.detail, problem.extras?.reason].filter(Boolean);
+    return parts.length > 0
+        ? `Horizon returned ${response.status}: ${parts.join(" — ")}`
+        : `Horizon returned ${response.status} ${response.statusText} for ${path}`;
+}
+/** Renders a Horizon asset triplet as "PI" or "CODE:ISSUER". */
+export function formatAsset(assetType, code, issuer) {
+    if (!assetType || assetType === "native")
+        return "PI";
+    return issuer ? `${code}:${issuer}` : (code ?? assetType);
+}
+/** Extracts Horizon's paging cursor from a `_links.next.href` value. */
+export function cursorFromLink(href) {
+    if (!href)
+        return undefined;
+    try {
+        return new URL(href, HORIZON_URL).searchParams.get("cursor") ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=horizon.js.map

package/dist/horizon.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * Pion — MCP server for Pi Network.
+ *
+ * v0.1 scope: Tier A only (see docs/tool-mapping.md) — zero-permission,
+ * read-only chain queries against Pi's public Horizon API. No API keys, no
+ * wallet secrets, no user consent required, and nothing here can move value.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { HORIZON_URL } from "./horizon.js";
+import { registerGetAccountPayments } from "./tools/get-account-payments.js";
+import { registerGetWalletBalance } from "./tools/get-wallet-balance.js";
+import { registerQueryTransaction } from "./tools/query-transaction.js";
+// Kept in sync with package.json by hand — it is the only duplicated string.
+const VERSION = "0.1.0";
+const NETWORK = HORIZON_URL.includes("testnet") ? "Pi Testnet" : `custom (${HORIZON_URL})`;
+if (process.argv.includes("--version") || process.argv.includes("-v")) {
+    process.stdout.write(`${VERSION}\n`);
+    process.exit(0);
+}
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    process.stdout.write([
+        `pion-mcp ${VERSION} — MCP server for Pi Network (read-only)`,
+        "",
+        "Runs an MCP server over stdio. Point an MCP client at it rather than",
+        "invoking it directly.",
+        "",
+        "Tools: get_wallet_balance, get_account_payments, query_transaction",
+        "",
+        "Environment:",
+        "  PION_HORIZON_URL  Horizon base URL (default: https://api.testnet.minepi.com)",
+        "",
+    ].join("\n"));
+    process.exit(0);
+}
+const server = new McpServer({ name: "pion-mcp", version: VERSION }, {
+    instructions: `Pion exposes read-only Pi Network chain data from Horizon at ${HORIZON_URL} ` +
+        `(${NETWORK}). All three tools are public ledger reads: they cannot send payments, ` +
+        "sign anything, or access a user's wallet. Amounts are decimal strings; Pi itself " +
+        'is reported as the asset "PI" and custom tokens as "CODE:ISSUER".',
+});
+registerGetWalletBalance(server, NETWORK);
+registerGetAccountPayments(server, NETWORK);
+registerQueryTransaction(server, NETWORK);
+async function main() {
+    // stdout is the JSON-RPC channel — every log line must go to stderr.
+    await server.connect(new StdioServerTransport());
+    console.error(`pion-mcp ${VERSION} ready on stdio — Horizon: ${HORIZON_URL} (${NETWORK})`);
+}
+main().catch((error) => {
+    console.error("pion-mcp failed to start:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,6EAA6E;AAC7E,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,WAAW,GAAG,CAAC;AAE3F,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,YAAY,OAAO,0CAA0C;QAC7D,EAAE;QACF,sEAAsE;QACtE,uBAAuB;QACvB,EAAE;QACF,oEAAoE;QACpE,EAAE;QACF,cAAc;QACd,gFAAgF;QAChF,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EACtC;IACE,YAAY,EACV,gEAAgE,WAAW,GAAG;QAC9E,IAAI,OAAO,yEAAyE;QACpF,mFAAmF;QACnF,mEAAmE;CACtE,CACF,CAAC;AAEF,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,qEAAqE;IACrE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,8BAA8B,WAAW,KAAK,OAAO,GAAG,CAAC,CAAC;AAC7F,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/common.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** Stellar/Pi public key: 56 base32 characters beginning with G. */
+export declare const walletAddress: z.ZodString;
+/** Stellar transaction hash: 64 hex characters. */
+export declare const transactionHash: z.ZodString;
+export declare const pagingLimit: z.ZodDefault<z.ZodNumber>;
+export declare const pagingCursor: z.ZodOptional<z.ZodString>;
+export declare const pagingOrder: z.ZodDefault<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+}>>;
+/** A successful tool result: JSON text for humans, structured content for agents. */
+export declare function ok<T extends Record<string, unknown>>(data: T): CallToolResult;
+/** A failed tool result. `isError` keeps the failure inside the conversation. */
+export declare function fail(error: unknown): CallToolResult;

package/dist/tools/common.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { HORIZON_URL, HorizonError } from "../horizon.js";
+/** Stellar/Pi public key: 56 base32 characters beginning with G. */
+export const walletAddress = z
+    .string()
+    .regex(/^G[A-Z2-7]{55}$/, "must be a 56-character Pi wallet address starting with G (e.g. GABC...XYZ)")
+    .describe("Pi wallet address (Stellar public key, 56 characters, starts with G)");
+/** Stellar transaction hash: 64 hex characters. */
+export const transactionHash = z
+    .string()
+    .regex(/^[0-9a-fA-F]{64}$/, "must be a 64-character hex transaction hash")
+    .describe("Transaction hash (64 hex characters)");
+export const pagingLimit = z
+    .number()
+    .int()
+    .min(1)
+    .max(200)
+    .default(10)
+    .describe("How many records to return (1-200). Defaults to 10.");
+export const pagingCursor = z
+    .string()
+    .optional()
+    .describe("Paging cursor from a previous call's `next_cursor`. Omit for the first page.");
+export const pagingOrder = z
+    .enum(["asc", "desc"])
+    .default("desc")
+    .describe("`desc` returns newest records first (the default); `asc` returns oldest first.");
+/** A successful tool result: JSON text for humans, structured content for agents. */
+export function ok(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        structuredContent: data,
+    };
+}
+/** A failed tool result. `isError` keeps the failure inside the conversation. */
+export function fail(error) {
+    const message = error instanceof HorizonError
+        ? error.message
+        : `Unexpected error querying ${HORIZON_URL}: ${error instanceof Error ? error.message : String(error)}`;
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+//# sourceMappingURL=common.js.map

package/dist/tools/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/tools/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1D,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CACJ,iBAAiB,EACjB,4EAA4E,CAC7E;KACA,QAAQ,CAAC,sEAAsE,CAAC,CAAC;AAEpF,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,mBAAmB,EAAE,6CAA6C,CAAC;KACzE,QAAQ,CAAC,sCAAsC,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,OAAO,CAAC,EAAE,CAAC;KACX,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,8EAA8E,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;KACrB,OAAO,CAAC,MAAM,CAAC;KACf,QAAQ,CAAC,gFAAgF,CAAC,CAAC;AAE9F,qFAAqF;AACrF,MAAM,UAAU,EAAE,CAAoC,IAAO;IAC3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAChE,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,MAAM,OAAO,GACX,KAAK,YAAY,YAAY;QAC3B,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,6BAA6B,WAAW,KACtC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CAAC;IACT,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC"}

package/dist/tools/get-account-payments.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetAccountPayments(server: McpServer, network: string): void;

package/dist/tools/get-account-payments.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { cursorFromLink, formatAsset, horizonGet } from "../horizon.js";
+import { fail, ok, pagingCursor, pagingLimit, pagingOrder, walletAddress } from "./common.js";
+const paymentShape = z.object({
+    id: z.string(),
+    type: z.string(),
+    created_at: z.string(),
+    transaction_hash: z.string(),
+    successful: z.boolean().optional(),
+    from: z.string().optional(),
+    to: z.string().optional(),
+    amount: z.string().optional(),
+    asset: z.string().optional(),
+    source_amount: z.string().optional(),
+    source_asset: z.string().optional(),
+});
+const outputSchema = {
+    network: z.string(),
+    account_id: z.string(),
+    count: z.number(),
+    next_cursor: z.string().optional(),
+    payments: z.array(paymentShape),
+};
+/** Flattens Horizon's per-type payment records into one consistent shape. */
+function normalize(record) {
+    const base = {
+        id: record.id,
+        type: record.type,
+        created_at: record.created_at,
+        transaction_hash: record.transaction_hash,
+        ...(record.transaction_successful !== undefined
+            ? { successful: record.transaction_successful }
+            : {}),
+    };
+    switch (record.type) {
+        case "create_account":
+            return {
+                ...base,
+                from: record.funder,
+                to: record.account,
+                amount: record.starting_balance,
+                asset: "PI",
+            };
+        case "account_merge":
+            return { ...base, from: record.account, to: record.into };
+        default:
+            // Covers payment, path_payment_*, and any other value-moving operation
+            // Horizon surfaces here (e.g. invoke_host_function), which may carry no
+            // asset fields at all — never assume native.
+            return {
+                ...base,
+                from: record.from,
+                to: record.to,
+                amount: record.amount,
+                ...(record.asset_type !== undefined
+                    ? { asset: formatAsset(record.asset_type, record.asset_code, record.asset_issuer) }
+                    : {}),
+                ...(record.source_amount !== undefined
+                    ? {
+                        source_amount: record.source_amount,
+                        source_asset: formatAsset(record.source_asset_type, record.source_asset_code, record.source_asset_issuer),
+                    }
+                    : {}),
+            };
+    }
+}
+export function registerGetAccountPayments(server, network) {
+    server.registerTool("get_account_payments", {
+        title: "List Pi wallet payment history",
+        description: "List payments sent to or from a Pi wallet address, newest first. " +
+            "Call this to answer questions about an address's transaction history — whether " +
+            "a payment arrived, who funded an account, or what it recently sent. Covers " +
+            "payments, account creations, path payments, and account merges. Results are " +
+            "paginated: pass the returned `next_cursor` back as `cursor` for the next page. " +
+            "Reads public ledger data only.",
+        inputSchema: {
+            address: walletAddress,
+            limit: pagingLimit,
+            cursor: pagingCursor,
+            order: pagingOrder,
+        },
+        outputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ address, limit, cursor, order }) => {
+        try {
+            const page = await horizonGet(`/accounts/${address}/payments`, {
+                limit,
+                order,
+                cursor,
+            });
+            const payments = page._embedded.records.map(normalize);
+            // Horizon always emits a `next` link, even past the end of the result
+            // set. Only surface a cursor when the page came back full.
+            const nextCursor = payments.length === limit ? cursorFromLink(page._links?.next?.href) : undefined;
+            return ok({
+                network,
+                account_id: address,
+                count: payments.length,
+                ...(nextCursor !== undefined ? { next_cursor: nextCursor } : {}),
+                payments,
+            });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+//# sourceMappingURL=get-account-payments.js.map

package/dist/tools/get-account-payments.js.map

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

package/dist/tools/get-wallet-balance.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetWalletBalance(server: McpServer, network: string): void;

package/dist/tools/get-wallet-balance.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { formatAsset, horizonGet } from "../horizon.js";
+import { fail, ok, walletAddress } from "./common.js";
+const outputSchema = {
+    network: z.string(),
+    account_id: z.string(),
+    sequence: z.string(),
+    subentry_count: z.number(),
+    last_modified_ledger: z.number(),
+    balances: z.array(z.object({
+        asset: z.string(),
+        balance: z.string(),
+        asset_type: z.string(),
+        limit: z.string().optional(),
+        is_authorized: z.boolean().optional(),
+    })),
+};
+export function registerGetWalletBalance(server, network) {
+    server.registerTool("get_wallet_balance", {
+        title: "Get Pi wallet balance",
+        description: "Read the current Pi and custom-token balances of a Pi wallet address. " +
+            "Call this whenever you need to know how much Pi an address holds, whether it " +
+            "holds a particular token, or whether the account exists on-chain at all. " +
+            "Reads public ledger data only — it cannot move funds and needs no credentials.",
+        inputSchema: { address: walletAddress },
+        outputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ address }) => {
+        try {
+            const account = await horizonGet(`/accounts/${address}`);
+            return ok({
+                network,
+                account_id: account.account_id,
+                sequence: account.sequence,
+                subentry_count: account.subentry_count,
+                last_modified_ledger: account.last_modified_ledger,
+                balances: account.balances.map((entry) => ({
+                    // Liquidity-pool shares carry a pool id instead of a code/issuer.
+                    asset: entry.liquidity_pool_id !== undefined
+                        ? `pool:${entry.liquidity_pool_id}`
+                        : formatAsset(entry.asset_type, entry.asset_code, entry.asset_issuer),
+                    balance: entry.balance,
+                    asset_type: entry.asset_type,
+                    ...(entry.limit !== undefined ? { limit: entry.limit } : {}),
+                    ...(entry.is_authorized !== undefined ? { is_authorized: entry.is_authorized } : {}),
+                })),
+            });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+//# sourceMappingURL=get-wallet-balance.js.map

package/dist/tools/get-wallet-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-wallet-balance.js","sourceRoot":"","sources":["../../src/tools/get-wallet-balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBtD,MAAM,YAAY,GAAG;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC,CACH;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,OAAe;IACzE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,wEAAwE;YACxE,+EAA+E;YAC/E,2EAA2E;YAC3E,gFAAgF;QAClF,WAAW,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE;QACvC,YAAY;QACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAiB,aAAa,OAAO,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;gBACR,OAAO;gBACP,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;gBAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACzC,kEAAkE;oBAClE,KAAK,EACH,KAAK,CAAC,iBAAiB,KAAK,SAAS;wBACnC,CAAC,CAAC,QAAQ,KAAK,CAAC,iBAAiB,EAAE;wBACnC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC;oBACzE,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrF,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/query-transaction.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerQueryTransaction(server: McpServer, network: string): void;

package/dist/tools/query-transaction.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { horizonGet } from "../horizon.js";
+import { fail, ok, transactionHash } from "./common.js";
+const outputSchema = {
+    network: z.string(),
+    hash: z.string(),
+    successful: z.boolean(),
+    ledger: z.number(),
+    created_at: z.string(),
+    source_account: z.string(),
+    source_account_sequence: z.string(),
+    fee_account: z.string().optional(),
+    fee_charged: z.string(),
+    operation_count: z.number(),
+    memo_type: z.string(),
+    memo: z.string().optional(),
+    result_code: z.string().optional(),
+};
+export function registerQueryTransaction(server, network) {
+    server.registerTool("query_transaction", {
+        title: "Look up a Pi transaction",
+        description: "Look up a single Pi transaction by its hash and report whether it succeeded, " +
+            "which ledger it landed in, who submitted it, the fee charged, and its memo. " +
+            "Call this to verify that a specific transaction actually went through — a user " +
+            "or another service claiming a payment was made is not proof; this is. " +
+            "Reads public ledger data only.",
+        inputSchema: { hash: transactionHash },
+        outputSchema,
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ hash }) => {
+        try {
+            const tx = await horizonGet(`/transactions/${hash.toLowerCase()}`);
+            return ok({
+                network,
+                hash: tx.hash,
+                successful: tx.successful,
+                ledger: tx.ledger,
+                created_at: tx.created_at,
+                source_account: tx.source_account,
+                source_account_sequence: tx.source_account_sequence,
+                ...(tx.fee_account !== undefined ? { fee_account: tx.fee_account } : {}),
+                fee_charged: tx.fee_charged,
+                operation_count: tx.operation_count,
+                memo_type: tx.memo_type,
+                ...(tx.memo !== undefined ? { memo: tx.memo } : {}),
+                ...(tx.result_code !== undefined ? { result_code: tx.result_code } : {}),
+            });
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+//# sourceMappingURL=query-transaction.js.map

package/dist/tools/query-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-transaction.js","sourceRoot":"","sources":["../../src/tools/query-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiBxD,MAAM,YAAY,GAAG;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,OAAe;IACzE,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,+EAA+E;YAC/E,8EAA8E;YAC9E,iFAAiF;YACjF,wEAAwE;YACxE,gCAAgC;QAClC,WAAW,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;QACtC,YAAY;QACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,UAAU,CAAqB,iBAAiB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,CAAC;gBACR,OAAO;gBACP,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,cAAc,EAAE,EAAE,CAAC,cAAc;gBACjC,uBAAuB,EAAE,EAAE,CAAC,uBAAuB;gBACnD,GAAG,CAAC,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,eAAe,EAAE,EAAE,CAAC,eAAe;gBACnC,SAAS,EAAE,EAAE,CAAC,SAAS;gBACvB,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,EAAE,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,12 +1,47 @@
 {
   "name": "pion-mcp",
-  "version": "0.0.1",
-  "description": "Pion — Model Context Protocol (MCP) server for Pi Network. Early development stub.",
-  "keywords": ["mcp", "model-context-protocol", "pi-network", "ai-agents", "blockchain"],
+  "version": "0.1.0",
+  "description": "Pion — Model Context Protocol (MCP) server for Pi Network. Read-only chain queries against Pi testnet Horizon.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "pi-network",
+    "ai-agents",
+    "blockchain",
+    "stellar",
+    "horizon"
+  ],
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/jleeblack/pion-mcp.git"
+    "url": "git+https://github.com/jleeblack/pion-mcp.git"
   },
-  "main": "index.js"
-}
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "pion-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "smoke": "node scripts/smoke.mjs",
+    "prepack": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "typescript": "^7.0.2"
+  }
+}

package/index.js

@@ -1 +0,0 @@
-console.log("Pion — MCP server for Pi Network. Coming soon: github.com/YOURUSERNAME/pion-mcp");