@aibtc/mcp-server 1.37.0 → 1.38.0

package/dist/tools/ordinals-marketplace.tools.js

@@ -0,0 +1,428 @@
+/**
+ * Ordinals Marketplace Tools
+ *
+ * MCP tools for buying, selling, and browsing ordinals/inscriptions on
+ * the Magic Eden marketplace (api-mainnet.magiceden.dev).
+ *
+ * Tools:
+ * - ordinals_get_listings:          Browse inscriptions listed for sale (no wallet required)
+ * - ordinals_list_for_sale:         List a wallet inscription for sale via ME PSBT flow
+ * - ordinals_list_for_sale_submit:  Submit the signed listing PSBT to finalize a listing
+ * - ordinals_buy:                   Buy a listed inscription — returns PSBT to sign + broadcast
+ * - ordinals_cancel_listing:        Cancel an active Magic Eden listing
+ *
+ * Read operations use the public Magic Eden API (unauthenticated).
+ * Write operations use the ME PSBT-based listing flow which requires wallet unlock.
+ *
+ * Magic Eden API docs: https://api-mainnet.magiceden.dev/swagger
+ */
+import { z } from "zod";
+import { NETWORK } from "../config/networks.js";
+import { getWalletManager } from "../services/wallet-manager.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+const ME_BASE = "https://api-mainnet.magiceden.dev/v2/ord/btc";
+const ME_API_KEY = process.env.MAGIC_EDEN_API_KEY ?? "";
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+async function meGet(path) {
+    const url = `${ME_BASE}${path}`;
+    const res = await fetch(url, {
+        headers: {
+            Accept: "application/json",
+            "User-Agent": "aibtc-mcp-server/1.0",
+            ...(ME_API_KEY ? { Authorization: `Bearer ${ME_API_KEY}` } : {}),
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Magic Eden API ${res.status}: ${body}`);
+    }
+    return res.json();
+}
+async function mePost(path, body) {
+    const url = `${ME_BASE}${path}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "User-Agent": "aibtc-mcp-server/1.0",
+            ...(ME_API_KEY ? { Authorization: `Bearer ${ME_API_KEY}` } : {}),
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let message;
+        try {
+            const parsed = JSON.parse(text);
+            message = String(parsed.message ?? text);
+        }
+        catch {
+            message = text;
+        }
+        throw new Error(`Magic Eden API ${res.status}: ${message}`);
+    }
+    return res.json();
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerOrdinalsMarketplaceTools(server) {
+    // ==========================================================================
+    // ordinals_get_listings — public read, no wallet required
+    // ==========================================================================
+    server.registerTool("ordinals_get_listings", {
+        description: `Browse ordinals/inscriptions listed for sale on Magic Eden.
+
+Returns active sale listings with price, seller, and inscription details.
+Supports filtering by collection symbol and price range. No wallet required.
+
+Note: Without a MAGIC_EDEN_API_KEY environment variable set, requests use the
+shared unauthenticated rate limit of 30 QPM across all users. Set MAGIC_EDEN_API_KEY
+to use an authenticated rate limit.
+
+Examples:
+- Browse all listings: ordinals_get_listings {}
+- Filter by collection: ordinals_get_listings { collection: "nodemonkes" }
+- Price range: ordinals_get_listings { minPriceSats: 100000, maxPriceSats: 1000000 }`,
+        inputSchema: {
+            collection: z
+                .string()
+                .optional()
+                .describe("Magic Eden collection symbol to filter by (e.g. 'nodemonkes', 'bitcoin-puppets')"),
+            minPriceSats: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .describe("Minimum listing price in satoshis"),
+            maxPriceSats: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Maximum listing price in satoshis"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .default(20)
+                .describe("Number of results to return (default 20, max 100)"),
+            offset: z
+                .number()
+                .int()
+                .nonnegative()
+                .optional()
+                .default(0)
+                .describe("Pagination offset (default 0)"),
+            sortBy: z
+                .enum(["priceAsc", "priceDesc", "recentlyListed"])
+                .optional()
+                .default("recentlyListed")
+                .describe("Sort order: priceAsc, priceDesc, or recentlyListed (default)"),
+        },
+    }, async ({ collection, minPriceSats, maxPriceSats, limit, offset, sortBy }) => {
+        try {
+            if (NETWORK !== "mainnet") {
+                return createJsonResponse({
+                    note: "Magic Eden ordinals marketplace is only available on mainnet.",
+                    network: NETWORK,
+                    listings: [],
+                });
+            }
+            const params = new URLSearchParams();
+            params.set("limit", String(limit ?? 20));
+            params.set("offset", String(offset ?? 0));
+            params.set("sortBy", sortBy ?? "recentlyListed");
+            if (collection)
+                params.set("collectionSymbol", collection);
+            if (minPriceSats !== undefined)
+                params.set("minPrice", String(minPriceSats));
+            if (maxPriceSats !== undefined)
+                params.set("maxPrice", String(maxPriceSats));
+            const data = await meGet(`/tokens?${params}`);
+            const tokens = data.tokens ?? data;
+            return createJsonResponse({
+                source: "magic_eden",
+                network: NETWORK,
+                filters: {
+                    collection: collection ?? null,
+                    minPriceSats: minPriceSats ?? null,
+                    maxPriceSats: maxPriceSats ?? null,
+                    sortBy: sortBy ?? "recentlyListed",
+                },
+                limit: limit ?? 20,
+                offset: offset ?? 0,
+                listings: tokens,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ==========================================================================
+    // ordinals_list_for_sale — requires wallet (ME PSBT listing)
+    // ==========================================================================
+    server.registerTool("ordinals_list_for_sale", {
+        description: `List a wallet inscription for sale on Magic Eden.
+
+Requests a PSBT-based listing transaction from the Magic Eden API.
+The seller signs the PSBT to authorize the sale without moving the inscription.
+Requires an unlocked wallet with Bitcoin (Taproot) keys.
+
+Steps:
+1. Call this tool with inscriptionId and priceSats
+2. Sign the returned PSBT using psbt_sign
+3. Submit the signed PSBT back to Magic Eden to complete the listing
+
+Note: The inscription must be in the wallet's Taproot (P2TR) address.`,
+        inputSchema: {
+            inscriptionId: z
+                .string()
+                .describe("Inscription ID in txid+index format, e.g. abc123...i0"),
+            priceSats: z
+                .number()
+                .int()
+                .positive()
+                .describe("Listing price in satoshis"),
+            receiverAddress: z
+                .string()
+                .optional()
+                .describe("BTC address to receive payment (defaults to wallet's Taproot address)"),
+        },
+    }, async ({ inscriptionId, priceSats, receiverAddress }) => {
+        try {
+            if (NETWORK !== "mainnet") {
+                return createErrorResponse(new Error("Magic Eden ordinals marketplace listing is only available on mainnet."));
+            }
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account) {
+                throw new Error("Wallet is not unlocked. Use wallet_unlock first.");
+            }
+            if (!account.taprootAddress) {
+                throw new Error("Taproot address not available. Unlock your wallet first.");
+            }
+            const sellerAddress = receiverAddress ?? account.taprootAddress;
+            // Request a listing PSBT from Magic Eden
+            const listingRequest = await mePost("/instructions/sell", {
+                inscriptionId,
+                price: priceSats,
+                sellerReceiveAddress: sellerAddress,
+                sellerOrdAddress: account.taprootAddress,
+            });
+            const result = listingRequest;
+            return createJsonResponse({
+                status: "psbt_ready",
+                message: "Magic Eden listing PSBT generated. Sign the PSBT using psbt_sign, then call " +
+                    "ordinals_list_for_sale_submit with the signed PSBT to finalize your listing.",
+                inscriptionId,
+                priceSats,
+                sellerAddress,
+                psbtBase64: result.psbtBase64 ?? result.psbt ?? null,
+                raw: result,
+                nextStep: "Use psbt_sign to sign the psbtBase64, then submit the signed PSBT to finalize listing.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ==========================================================================
+    // ordinals_list_for_sale_submit — requires signed PSBT from ordinals_list_for_sale
+    // ==========================================================================
+    server.registerTool("ordinals_list_for_sale_submit", {
+        description: `Submit a signed listing PSBT to Magic Eden to finalize an ordinal listing.
+
+Call this after signing the PSBT returned by ordinals_list_for_sale.
+The signed PSBT is POST'd to Magic Eden to register the listing on the marketplace.
+
+Steps:
+1. Call ordinals_list_for_sale to get a listing PSBT
+2. Sign the PSBT using psbt_sign
+3. Call this tool with the signed PSBT to publish the listing`,
+        inputSchema: {
+            inscriptionId: z
+                .string()
+                .describe("The inscription ID being listed"),
+            signedPsbt: z
+                .string()
+                .describe("The signed PSBT in base64 format returned by psbt_sign"),
+        },
+    }, async ({ inscriptionId, signedPsbt }) => {
+        try {
+            if (NETWORK !== "mainnet") {
+                return createErrorResponse(new Error("Magic Eden ordinals marketplace listing is only available on mainnet."));
+            }
+            const result = await mePost("/instructions/sell/submit", {
+                signedPsbt,
+                inscriptionId,
+            });
+            return createJsonResponse({ status: "listed", result });
+        }
+        catch (err) {
+            return createErrorResponse(`Failed to submit listing: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    // ==========================================================================
+    // ordinals_buy — requires wallet (ME PSBT buy flow)
+    // ==========================================================================
+    server.registerTool("ordinals_buy", {
+        description: `Buy a listed inscription from Magic Eden.
+
+Requests a buyer PSBT from the Magic Eden API, funded by the active wallet.
+Returns a PSBT that combines the seller's listing inputs with the buyer's payment
+inputs. The buyer signs the PSBT then broadcasts it to complete the purchase.
+
+Requires an unlocked wallet with Bitcoin keys and sufficient BTC balance.
+
+Steps:
+1. Call ordinals_get_listings to find an inscription and its price
+2. Call ordinals_buy with the inscriptionId and desired buyer address
+3. Sign the returned PSBT using psbt_sign
+4. Broadcast using psbt_broadcast`,
+        inputSchema: {
+            inscriptionId: z
+                .string()
+                .describe("Inscription ID to purchase, e.g. abc123...i0"),
+            buyerAddress: z
+                .string()
+                .optional()
+                .describe("BTC address to receive the inscription (defaults to wallet's Taproot address)"),
+            buyerPaymentAddress: z
+                .string()
+                .optional()
+                .describe("BTC address to fund the purchase (defaults to wallet's SegWit address)"),
+            feeRate: z
+                .number()
+                .positive()
+                .optional()
+                .describe("Fee rate in sat/vB (optional, uses network default if omitted)"),
+        },
+    }, async ({ inscriptionId, buyerAddress, buyerPaymentAddress, feeRate }) => {
+        try {
+            if (NETWORK !== "mainnet") {
+                return createErrorResponse(new Error("Magic Eden ordinals marketplace is only available on mainnet."));
+            }
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account) {
+                throw new Error("Wallet is not unlocked. Use wallet_unlock first.");
+            }
+            if (!account.taprootAddress) {
+                throw new Error("Taproot address not available. Unlock your wallet first.");
+            }
+            if (!account.btcAddress) {
+                throw new Error("Bitcoin SegWit address not available. Unlock your wallet first.");
+            }
+            const receiveAddress = buyerAddress ?? account.taprootAddress;
+            const paymentAddress = buyerPaymentAddress ?? account.btcAddress;
+            // Fetch token info (including active listing) from ME
+            const tokenInfo = await meGet(`/tokens/${inscriptionId}`);
+            if (!tokenInfo.listed && !(tokenInfo.listedPrice ?? tokenInfo.price)) {
+                return createJsonResponse({
+                    status: "not_listed",
+                    message: `Inscription ${inscriptionId} does not appear to be listed for sale on Magic Eden.`,
+                    inscriptionId,
+                    tokenInfo,
+                });
+            }
+            const priceSats = Number(tokenInfo.listedPrice ?? tokenInfo.price);
+            // Request a buy PSBT from Magic Eden
+            const buyRequest = await mePost("/instructions/buy", {
+                price: priceSats,
+                tokenId: inscriptionId,
+                buyerAddress: receiveAddress,
+                buyerTokenReceiveAddress: receiveAddress,
+                feeRateTier: feeRate ? undefined : "halfHourFee",
+                feeRate: feeRate,
+                buyerPaymentAddress: paymentAddress,
+                buyerPaymentPublicKey: account.btcPublicKey ? Buffer.from(account.btcPublicKey).toString("hex") : undefined,
+            });
+            const result = buyRequest;
+            return createJsonResponse({
+                status: "psbt_ready",
+                message: "Magic Eden buy PSBT generated. Sign the PSBT using psbt_sign, then broadcast " +
+                    "using psbt_broadcast to complete the purchase.",
+                inscriptionId,
+                priceSats,
+                buyerReceiveAddress: receiveAddress,
+                buyerPaymentAddress: paymentAddress,
+                psbtBase64: result.psbtBase64 ?? result.psbt ?? null,
+                raw: result,
+                nextStep: "Use psbt_sign to sign the psbtBase64, then use psbt_broadcast to send the transaction.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ==========================================================================
+    // ordinals_cancel_listing — requires wallet (ME PSBT cancel flow)
+    // ==========================================================================
+    server.registerTool("ordinals_cancel_listing", {
+        description: `Cancel an active Magic Eden listing for an inscription.
+
+Requests a cancellation PSBT from Magic Eden. The seller signs the PSBT to
+invalidate the active listing and reclaim the inscription UTXO. No BTC fee
+is required beyond the miner fee for the cancellation transaction itself.
+
+Requires an unlocked wallet with Bitcoin (Taproot) keys.
+
+Steps:
+1. Call this tool with the inscriptionId you want to delist
+2. Sign the returned PSBT using psbt_sign
+3. Broadcast using psbt_broadcast to finalize the cancellation`,
+        inputSchema: {
+            inscriptionId: z
+                .string()
+                .describe("Inscription ID of the active listing to cancel, e.g. abc123...i0"),
+            sellerAddress: z
+                .string()
+                .optional()
+                .describe("BTC Taproot address that owns the listing (defaults to wallet's Taproot address)"),
+        },
+    }, async ({ inscriptionId, sellerAddress }) => {
+        try {
+            if (NETWORK !== "mainnet") {
+                return createErrorResponse(new Error("Magic Eden ordinals marketplace is only available on mainnet."));
+            }
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account) {
+                throw new Error("Wallet is not unlocked. Use wallet_unlock first.");
+            }
+            if (!account.taprootAddress) {
+                throw new Error("Taproot address not available. Unlock your wallet first.");
+            }
+            const ownerAddress = sellerAddress ?? account.taprootAddress;
+            // Request a cancel listing PSBT from Magic Eden
+            const cancelRequest = await mePost("/instructions/cancel", {
+                inscriptionId,
+                sellerOrdAddress: ownerAddress,
+            });
+            const result = cancelRequest;
+            return createJsonResponse({
+                status: "psbt_ready",
+                message: "Magic Eden cancellation PSBT generated. Sign the PSBT using psbt_sign, then " +
+                    "broadcast using psbt_broadcast to finalize the cancellation.",
+                inscriptionId,
+                sellerAddress: ownerAddress,
+                psbtBase64: result.psbtBase64 ?? result.psbt ?? null,
+                raw: result,
+                nextStep: "Use psbt_sign to sign the psbtBase64, then use psbt_broadcast to send the cancellation transaction.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=ordinals-marketplace.tools.js.map

package/dist/tools/ordinals-marketplace.tools.js.map

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

package/dist/tools/reputation.tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Reputation Tools (ERC-8004)
+ *
+ * Dedicated MCP tools for on-chain agent reputation management via the
+ * ERC-8004 reputation registry. Covers the full feedback lifecycle:
+ *
+ * Read Tools (no wallet required):
+ * - reputation_get_summary       - Aggregated reputation score for an agent
+ * - reputation_read_feedback     - Specific feedback entry by agent + index
+ * - reputation_read_all_feedback - Paginated all-feedback with tag filtering
+ * - reputation_get_clients       - Paginated list of clients who gave feedback
+ * - reputation_get_feedback_count - Total feedback count for an agent
+ * - reputation_get_approved_limit - Approved index limit for a client
+ * - reputation_get_last_index    - Last feedback index for a client
+ *
+ * Write Tools (wallet required):
+ * - reputation_give_feedback     - Submit feedback for an agent
+ * - reputation_revoke_feedback   - Revoke own feedback by index
+ * - reputation_append_response   - Append a response to received feedback
+ * - reputation_approve_client    - Approve a client with index limit
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReputationTools(server: McpServer): void;
+//# sourceMappingURL=reputation.tools.d.ts.map

package/dist/tools/reputation.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.tools.d.ts","sourceRoot":"","sources":["../../src/tools/reputation.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4gB/D"}