@ramp-kit/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Armando Cruz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# @ramp-kit/mcp
+
+MCP (Model Context Protocol) server for the
+[LATAM Ramp Kit](https://github.com/armandocodecr/latam-ramp-kit): lets AI
+agents (Claude Code, Claude Desktop, Cursor, or any MCP client) explore,
+explain and **operate** LATAM fiat ramps on Stellar.
+
+Works with zero configuration (mock provider) and comes alive with an
+Etherfuse sandbox key — agents can then fetch real quotes, create sandbox
+orders, simulate PIX/SPEI deposits and watch them settle on Stellar Testnet.
+
+## Setup
+
+Claude Code:
+
+```bash
+claude mcp add ramp-kit -e ETHERFUSE_API_KEY=api_sand_… -- npx -y @ramp-kit/mcp
+```
+
+Any MCP client (`mcpServers` config):
+
+```json
+{
+  "mcpServers": {
+    "ramp-kit": {
+      "command": "npx",
+      "args": ["-y", "@ramp-kit/mcp"],
+      "env": { "ETHERFUSE_API_KEY": "api_sand_…" }
+    }
+  }
+}
+```
+
+Environment variables (all optional):
+
+| Variable | Effect |
+| --- | --- |
+| `ETHERFUSE_API_KEY` | Enables live Etherfuse tools (sandbox key: [sandbox.etherfuse.com](https://sandbox.etherfuse.com)) |
+| `MANTECA_API_KEY` | Enables the Manteca provider in routing/comparison |
+| `RAMPKIT_ENV` | `sandbox` (default) or `production` |
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `get_documentation` | Built-in docs: overview, quickstart, sandbox-setup, architecture, production, troubleshooting |
+| `list_providers` | Configured providers + capabilities (countries, rails, networks) |
+| `list_assets` | Tradable assets (environment-specific identifiers) |
+| `get_quote` | Live quote with rate, fees and expiry countdown |
+| `compare_quotes` | Same request fanned out to every eligible provider |
+| `create_order` | Quote → order, returns PIX/SPEI deposit instructions |
+| `get_order` | Normalized order status until settled/failed |
+| `simulate_deposit` | **Sandbox-only**: simulate the incoming fiat payment |
+| `get_wallet_state` | Stellar account existence, balances, pending claimable balances |
+
+## Safety
+
+- Never handles secret keys — signing stays in the user's wallet
+  (`claimPendingBalances` in `@ramp-kit/core` takes a signing callback).
+- `simulate_deposit` refuses to run when `RAMPKIT_ENV=production`.
+- Quotes are session-scoped; orders only execute against the environment the
+  server was configured for.
+
+## Example agent session
+
+> "Quote 100 BRL to USDC on Stellar and walk me through what happens"
+
+The agent calls `list_assets` → `get_quote` → explains the rate/fees/expiry,
+then optionally `create_order` → `simulate_deposit` → `get_order` until
+`settled`, and `get_wallet_state` to show the delivered tokens.
+
+MIT © [Armando Cruz](https://github.com/armandocodecr) ·
+[Repository](https://github.com/armandocodecr/latam-ramp-kit)

package/dist/docs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Embedded documentation served by the get_documentation tool. Condensed
+ * from the repository docs so agents can answer without network access.
+ */
+export declare const TOPICS: readonly ["overview", "quickstart", "sandbox-setup", "architecture", "production", "troubleshooting"];
+export type Topic = (typeof TOPICS)[number];
+export declare const DOCS: Record<Topic, string>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,MAAM,uGAOT,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CA2LtC,CAAC"}

package/dist/docs.js

@@ -0,0 +1,196 @@
+/**
+ * Embedded documentation served by the get_documentation tool. Condensed
+ * from the repository docs so agents can answer without network access.
+ */
+export const TOPICS = [
+    "overview",
+    "quickstart",
+    "sandbox-setup",
+    "architecture",
+    "production",
+    "troubleshooting",
+];
+export const DOCS = {
+    overview: `# LATAM Ramp Kit — overview
+
+**Problem it solves:** every LATAM app that moves money between banks and
+blockchains re-integrates ramp providers from scratch. Each provider has its
+own API, auth, KYC model, order states and price-expiry rules — and none
+covers the whole region (the best Brazil/PIX rails don't settle on Stellar;
+the Stellar-native provider is Mexico-first). Weeks of work, duplicated by
+every team.
+
+**Solution:** one TypeScript interface (\`RampProvider\`) over real providers,
+with a normalized order lifecycle, a prebuilt React widget, a provider
+router, Stellar-specific helpers, and a production backend. Swap providers
+with one line.
+
+**Packages (npm):**
+- \`@ramp-kit/core\` — SDK: EtherfuseProvider (Stellar-native, PIX/SPEI),
+  MantecaProvider (LATAM rails, EVM/Tron settlement), MockProvider (dev),
+  RampRouter (country/currency routing + live quote comparison), Stellar
+  helpers (trustlines, claimable-balance claims, tx signing).
+- \`@ramp-kit/react\` — <RampWidget /> 3-step flow + useQuote/useOrder hooks.
+- \`@ramp-kit/server\` — zero-dependency production proxy (server-held API
+  key, endpoint allowlist) + webhook signature verification.
+- \`@ramp-kit/mcp\` — this MCP server.
+
+**Proven end-to-end on Stellar Testnet:** 100 BRL entered via PIX (Etherfuse
+sandbox) and settled as 19.0097 USDC in a fresh Stellar wallet — account
+creation sponsored by the provider, tokens delivered via claimable balance,
+claimed with one kit helper. Repo:
+https://github.com/armandocodecr/latam-ramp-kit`,
+    quickstart: `# Quickstart
+
+## Zero credentials (MockProvider)
+\`\`\`ts
+import { MockProvider } from "@ramp-kit/core";
+const provider = new MockProvider({ autoFundMs: 4000 });
+const assets = await provider.listAssets("stellar");
+const quote = await provider.getQuote({
+  direction: "onramp", fiatCurrency: "BRL",
+  assetIdentifier: assets[0].identifier, network: "stellar",
+  sourceAmount: "100", customerId: "user-1",
+});
+const order = await provider.createOrder(quote);
+// order auto-advances: awaiting_deposit → processing → settled
+\`\`\`
+
+## Real sandbox (Etherfuse, Stellar Testnet, no real money)
+\`\`\`ts
+import { EtherfuseProvider } from "@ramp-kit/core";
+const provider = new EtherfuseProvider({ apiKey, environment: "sandbox" });
+
+const org = await provider.getOrganization();          // customerId
+const accounts = await provider.listBankAccounts();     // pick compliant one
+provider.setBankAccount(accounts.find(a => a.compliant)!.bankAccountId);
+await provider.registerWallet(walletAddress, "stellar"); // one-time, required
+
+const assets = await provider.listAssets("stellar", { currency: "brl" });
+const quote = await provider.getQuote({ direction: "onramp",
+  fiatCurrency: "BRL", assetIdentifier: assets[0].identifier,
+  network: "stellar", sourceAmount: "100",
+  customerId: org.id, walletAddress });
+const order = await provider.createOrder(quote);
+await provider.simulateFiatReceived(order.id);          // sandbox only
+// poll provider.getOrder(order.id) until "settled"
+\`\`\`
+
+## React widget
+\`\`\`tsx
+import { RampWidget } from "@ramp-kit/react";
+<RampWidget provider={provider} customerId={org.id} fiatCurrency="BRL"
+  network="stellar" walletAddress={wallet} assets={assets} />
+\`\`\`
+
+Key rules: quotes expire (Etherfuse: 2 min) — check \`expiresAt\`; never
+hardcode asset identifiers — always discover via listAssets(); wallets must
+be registered before their first order.`,
+    "sandbox-setup": `# Etherfuse sandbox setup (one time, ~10 minutes)
+
+1. Create an account at https://sandbox.etherfuse.com
+2. Approve your own KYB with the sandbox "Approve KYB" button (instant).
+3. Bank account for the fiat leg:
+   - **BRL/PIX (recommended):** dashboard → "Add BRL Bank Account (PIX)" —
+     pre-filled with test values, compliant instantly.
+   - **MXN/SPEI:** register with test RFC XEXX010101000 (personal) or
+     XEX010101000 (business); CLABE must NOT start with 646 (STP rejected).
+     API-registered MXN accounts await async approval (email arrives later).
+4. Copy your api_sand_… key from Account → Manage.
+
+Sandbox behaviors worth knowing:
+- Base URL: https://api.sand.etherfuse.com — Stellar Testnet settlement.
+- Simulate incoming fiat: POST /ramp/order/fiat_received (≤500 per quote) —
+  in the SDK: provider.simulateFiatReceived(orderId).
+- KYC accepts fake data and auto-approves.
+- Fresh wallets don't need funding: Etherfuse sponsors account creation and
+  delivers tokens as claimable balances (claim with claimPendingBalances).
+
+Manteca sandbox (https://sandbox.manteca.dev/crypto/v2) requires credentials
+from the Manteca team (not self-service): md-api-key header, faucet at
+faucet.manteca.dev, PIX test QRs ("pix", "pixmanualamount"), names containing
+"fail" simulate rejected onboarding.`,
+    architecture: `# Architecture
+
+## Normalized lifecycle (every provider maps into this)
+created → awaiting_deposit → awaiting_signature? → processing → settled
+                                                             ↘ failed | cancelled
+
+## Provider model mapping
+| Concept | Etherfuse | Manteca | Kit exposes |
+| Pricing | quote (2 min) | price lock (expireAt) | RampQuote.expiresAt |
+| Execution | order | synthetic (stages) | RampOrder.status |
+| Deposit info | CLABE / PIX charge | details.depositAddress | DepositInstructions |
+
+## Stellar specifics the kit absorbs
+- Trustlines: receiving any non-XLM asset requires one (+0.5 XLM reserve).
+- Sponsored onboarding: Etherfuse funds new accounts (~1.5 XLM) and delivers
+  tokens as claimable balances; claimPendingBalances() builds trustline +
+  claim in one tx with callback-based signing (Freighter/hardware pluggable).
+- Provider-built txs expire in ~1-2 min → regenerateTx(orderId) on
+  tx_too_late.
+- Asset ids are "CODE:ISSUER" and differ per environment — always discover.
+
+## Router
+RampRouter.register(provider…).resolve({country, fiatCurrency}) picks the
+best provider (Stellar-native preferred); compareQuotes() fans out a request
+and returns live quotes sorted by best target amount.
+
+## Errors
+RampError { provider, code: auth | quote_expired | tx_expired |
+kyc_required | unsupported | network | provider_error }.`,
+    production: `# Path to production
+
+## Ready in code today
+- environment: "sandbox" | "production" on every provider flips base URLs;
+  stellarConfigFor("production") → mainnet Horizon + passphrase.
+- @ramp-kit/server: createRampServer({ proxy, webhooks }) — API key stays
+  server-side; browser reaches an allowlisted surface only (quote/order/
+  status/assets); sandbox simulation hard-blocked in production.
+- Webhooks: createEtherfuseWebhookHandler verifies X-Signature (HMAC-SHA256
+  over RFC 8785-canonicalized JSON, constant-time compare), acks 2xx fast,
+  dispatches typed events. verifyMantecaSignature for Manteca's HMAC.
+- Signing is callback-based → real wallets (Freighter/hardware) plug in.
+
+## External steps (provider onboarding, not code)
+1. Etherfuse production KYB (manual legal-entity review, days/weeks) →
+   api_prod_… key; register real bank accounts (real CLABE/RFC); confirm
+   BRL/PIX production availability (live in sandbox, listed upcoming for
+   production).
+2. End-user KYC: hosted identity flow with real documents + liveness.
+3. Manteca: commercial onboarding → production md-api-key, per-country
+   permissions (BRL/PIX), webhook secret + signature header confirmation.
+4. Deploy @ramp-kit/server behind HTTPS; register webhook URL via
+   POST /ramp/webhook; store the one-time secret.
+5. Persist quote/order idempotency UUIDs and webhook events (dedupe by
+   resource id + status).
+
+## Frontend switch
+Point the provider at your proxy instead of the sandbox:
+new EtherfuseProvider({ apiKey: "", baseUrl: "https://api.myapp.com/etherfuse" })`,
+    troubleshooting: `# Troubleshooting (verified against the real sandbox)
+
+- "Wallet not found or not authorized" on POST /ramp/order → the wallet was
+  never registered. Call provider.registerWallet(publicKey, "stellar")
+  (claimOwnership=true lets a KYB-approved org skip per-wallet KYC).
+- "Bank account is not compliant with KYC requirements" → the selected bank
+  account's compliant flag is false. MXN accounts registered via API await
+  async approval; dashboard-created BRL/PIX accounts are compliant
+  instantly. Pick another account (listBankAccounts shows the flag).
+- "Proxy account not found" on order creation → the bank account is
+  compliant but not provisioned for that rail (seen with some BRL accounts).
+  Use the PIX account created via the dashboard button.
+- "Query deserialize error: missing field …" on GET /ramp/assets → the
+  endpoint requires blockchain + currency + wallet; the SDK fills defaults,
+  raw callers must pass all three.
+- STP CLABEs rejected → sandbox refuses CLABEs starting with 646; use
+  another bank code (e.g. 012…).
+- tx_too_late on submit → provider-built Stellar txs expire in ~1-2 min;
+  call regenerateTx(orderId) and re-sign (signAndSubmit raises
+  RampError("tx_expired") to signal this).
+- Quote expired → quotes live 2 minutes; re-quote (useQuote does this
+  automatically in React).
+- Claimable balance not received in wallet balance → it's waiting to be
+  claimed: getPendingBalances(pub) then claimPendingBalances(pub, sign).`,
+};
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU;IACV,YAAY;IACZ,eAAe;IACf,cAAc;IACd,YAAY;IACZ,iBAAiB;CACT,CAAC;AAIX,MAAM,CAAC,MAAM,IAAI,GAA0B;IACzC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA4BoC;IAE9C,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA6C0B;IAEtC,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;qCAuBkB;IAEnC,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDA4ByC;IAEvD,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA4BoE;IAEhF,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;yEAuBsD;CACxE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { EtherfuseProvider, MantecaProvider, MockProvider, RampRouter, getAccountState, getPendingBalances, stellarConfigFor, } from "@ramp-kit/core";
+import { DOCS, TOPICS } from "./docs.js";
+/**
+ * MCP server for the LATAM Ramp Kit.
+ *
+ * Configuration (environment variables):
+ * - ETHERFUSE_API_KEY  — enables live Etherfuse tools (otherwise mock only)
+ * - MANTECA_API_KEY    — enables the Manteca provider in the router
+ * - RAMPKIT_ENV        — "sandbox" (default) | "production"
+ *
+ * Safety: never handles secret keys — signing stays in the user's wallet.
+ * The deposit simulation tool refuses to run outside the sandbox.
+ */
+const environment = (process.env.RAMPKIT_ENV ?? "sandbox");
+const etherfuseKey = process.env.ETHERFUSE_API_KEY;
+const mantecaKey = process.env.MANTECA_API_KEY;
+const mock = new MockProvider({ autoFundMs: 4000 });
+const etherfuse = etherfuseKey
+    ? new EtherfuseProvider({ apiKey: etherfuseKey, environment })
+    : null;
+const manteca = mantecaKey
+    ? new MantecaProvider({ apiKey: mantecaKey, environment })
+    : null;
+const router = new RampRouter();
+if (etherfuse)
+    router.register(etherfuse);
+if (manteca)
+    router.register(manteca);
+router.register(mock);
+/** Quotes are stateful between get_quote and create_order. */
+const quotes = new Map();
+function resolveProvider(name) {
+    if (!name || name === "auto")
+        return etherfuse ?? mock;
+    const found = [etherfuse, manteca, mock].find((p) => p?.name === name);
+    if (!found) {
+        throw new Error(`Provider "${name}" not configured. Available: ${[etherfuse, manteca, mock]
+            .filter(Boolean)
+            .map((p) => p.name)
+            .join(", ")}`);
+    }
+    return found;
+}
+function text(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof value === "string" ? value : JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+const server = new McpServer({ name: "ramp-kit", version: "0.1.0" });
+server.tool("get_documentation", "LATAM Ramp Kit documentation. Topics: overview (what it is and solves), quickstart (code to integrate), sandbox-setup (Etherfuse/Manteca test credentials), architecture (lifecycle, provider mapping, Stellar specifics), production (path to mainnet), troubleshooting (verified error fixes). Start here.", { topic: z.enum(TOPICS).describe("Documentation topic to read") }, async ({ topic }) => text(DOCS[topic]));
+server.tool("list_providers", "List configured ramp providers with their capabilities (countries, fiat currencies, settlement networks, Stellar-native flag) and whether live credentials are present.", {}, async () => text({
+    environment,
+    providers: [etherfuse, manteca, mock].filter(Boolean).map((p) => ({
+        name: p.name,
+        live: p.name !== "mock",
+        capabilities: p.capabilities,
+    })),
+    note: etherfuse
+        ? undefined
+        : "No ETHERFUSE_API_KEY set — only the mock provider is available. Get a sandbox key at https://sandbox.etherfuse.com",
+}));
+server.tool("list_assets", "List tradable assets for a provider on a network. Asset identifiers are environment-specific — always use these, never hardcode.", {
+    provider: z.string().optional().describe('Provider name or "auto" (default)'),
+    network: z.string().optional().describe("Network, default stellar"),
+    currency: z.string().optional().describe("Fiat currency hint, e.g. brl"),
+}, async ({ provider, network, currency }) => {
+    const p = resolveProvider(provider);
+    const assets = await p.listAssets((network ?? "stellar"), {
+        currency: currency ?? "brl",
+    });
+    return text({ provider: p.name, assets });
+});
+server.tool("get_quote", "Get a live ramp quote (fiat→crypto or crypto→fiat). Returns target amount, rate, fees and expiry. The quote id can be passed to create_order before it expires.", {
+    provider: z.string().optional(),
+    direction: z.enum(["onramp", "offramp"]),
+    fiatCurrency: z.string().describe("e.g. BRL, MXN"),
+    assetIdentifier: z.string().describe("From list_assets"),
+    network: z.string().optional().describe("Default stellar"),
+    sourceAmount: z.string().describe("Decimal string, fiat for onramp"),
+    walletAddress: z.string().optional().describe("Destination Stellar address"),
+}, async (args) => {
+    const p = resolveProvider(args.provider);
+    let customerId = "mcp-user";
+    if (p instanceof EtherfuseProvider) {
+        customerId = (await p.getOrganization()).id;
+    }
+    const request = {
+        direction: args.direction,
+        fiatCurrency: args.fiatCurrency,
+        assetIdentifier: args.assetIdentifier,
+        network: (args.network ?? "stellar"),
+        sourceAmount: args.sourceAmount,
+        customerId,
+        walletAddress: args.walletAddress,
+    };
+    const quote = await p.getQuote(request);
+    quotes.set(quote.id, { provider: p, quote });
+    return text({
+        quoteId: quote.id,
+        provider: quote.provider,
+        youPay: `${quote.request.sourceAmount} ${quote.request.fiatCurrency}`,
+        youReceive: quote.targetAmount,
+        rate: quote.rate,
+        fees: quote.fees,
+        expiresAt: quote.expiresAt.toISOString(),
+        secondsLeft: Math.max(0, Math.floor((quote.expiresAt.getTime() - Date.now()) / 1000)),
+    });
+});
+server.tool("compare_quotes", "Fan the same quote request out to every eligible provider and compare live rates (multi-anchor comparison).", {
+    direction: z.enum(["onramp", "offramp"]),
+    fiatCurrency: z.string(),
+    assetIdentifier: z.string(),
+    network: z.string().optional(),
+    sourceAmount: z.string(),
+    walletAddress: z.string().optional(),
+}, async (args) => {
+    let customerId = "mcp-user";
+    if (etherfuse)
+        customerId = (await etherfuse.getOrganization()).id;
+    const request = {
+        direction: args.direction,
+        fiatCurrency: args.fiatCurrency,
+        assetIdentifier: args.assetIdentifier,
+        network: (args.network ?? "stellar"),
+        sourceAmount: args.sourceAmount,
+        customerId,
+        walletAddress: args.walletAddress,
+    };
+    const results = await router.compareQuotes(request, {
+        fiatCurrency: request.fiatCurrency,
+        network: request.network,
+    });
+    for (const q of results) {
+        const p = [etherfuse, manteca, mock].find((x) => x?.name === q.provider);
+        if (p)
+            quotes.set(q.id, { provider: p, quote: q });
+    }
+    return text(results.map((q) => ({
+        provider: q.provider,
+        quoteId: q.id,
+        youReceive: q.targetAmount,
+        rate: q.rate,
+        expiresAt: q.expiresAt.toISOString(),
+    })));
+});
+server.tool("create_order", "Turn a live quote (from get_quote/compare_quotes) into an order. Returns the normalized order with deposit instructions (PIX charge or SPEI CLABE). Sandbox/mock only through this server unless RAMPKIT_ENV=production.", {
+    quoteId: z.string().describe("Quote id returned by get_quote"),
+    bankAccountId: z
+        .string()
+        .optional()
+        .describe("Etherfuse fiat-leg bank account (defaults to first compliant)"),
+}, async ({ quoteId, bankAccountId }) => {
+    const entry = quotes.get(quoteId);
+    if (!entry) {
+        throw new Error(`Unknown quoteId ${quoteId} — quotes are session-scoped; call get_quote first`);
+    }
+    const { provider, quote } = entry;
+    if (provider instanceof EtherfuseProvider) {
+        if (bankAccountId) {
+            provider.setBankAccount(bankAccountId);
+        }
+        else {
+            const accounts = await provider.listBankAccounts();
+            const compliant = accounts.find((a) => a.compliant);
+            if (!compliant) {
+                throw new Error("No compliant bank account found — create a PIX account in the Etherfuse sandbox dashboard");
+            }
+            provider.setBankAccount(compliant.bankAccountId);
+        }
+        if (quote.request.walletAddress) {
+            await provider.registerWallet(quote.request.walletAddress, quote.request.network);
+        }
+    }
+    const order = await provider.createOrder(quote);
+    return text({
+        orderId: order.id,
+        provider: order.provider,
+        status: order.status,
+        depositInstructions: order.depositInstructions,
+        nextStep: provider.name === "etherfuse" && environment === "sandbox"
+            ? "Fund it with simulate_deposit (sandbox), then poll get_order until settled"
+            : "Fund the deposit, then poll get_order until settled",
+    });
+});
+server.tool("get_order", "Fetch the current normalized state of an order (created → awaiting_deposit → processing → settled | failed | cancelled).", {
+    provider: z.string().optional(),
+    orderId: z.string(),
+}, async ({ provider, orderId }) => {
+    const p = resolveProvider(provider);
+    const order = await p.getOrder(orderId);
+    return text({
+        orderId: order.id,
+        status: order.status,
+        txHash: order.txHash,
+        failureReason: order.failureReason,
+        updatedAt: order.updatedAt.toISOString(),
+    });
+});
+server.tool("simulate_deposit", "SANDBOX ONLY: simulate the incoming fiat transfer (PIX/SPEI) for an order, as if the user paid. Refuses to run in production.", {
+    provider: z.string().optional(),
+    orderId: z.string(),
+}, async ({ provider, orderId }) => {
+    if (environment === "production") {
+        throw new Error("simulate_deposit is sandbox-only");
+    }
+    const p = resolveProvider(provider);
+    if (!("simulateFiatReceived" in p)) {
+        throw new Error(`Provider ${p.name} does not support deposit simulation`);
+    }
+    await p.simulateFiatReceived(orderId);
+    return text({
+        ok: true,
+        note: "Deposit simulated — poll get_order until status is settled",
+    });
+});
+server.tool("get_wallet_state", "Inspect a Stellar wallet: does the account exist, XLM balance, asset balances, and claimable balances waiting to be claimed (sponsored onramp deliveries).", {
+    publicKey: z.string().describe("Stellar public key (G…)"),
+    assetIdentifier: z
+        .string()
+        .optional()
+        .describe('Optional "CODE:ISSUER" to check a specific trustline'),
+}, async ({ publicKey, assetIdentifier }) => {
+    const stellar = stellarConfigFor(environment);
+    const pending = await getPendingBalances(publicKey, stellar);
+    let state = null;
+    if (assetIdentifier) {
+        state = await getAccountState(publicKey, assetIdentifier, stellar);
+    }
+    return text({
+        network: environment === "production" ? "mainnet" : "testnet",
+        accountState: state,
+        pendingClaimableBalances: pending,
+        note: pending.length > 0
+            ? "Claim with claimPendingBalances(publicKey, sign) from @ramp-kit/core — signing happens in the user's wallet, never share secret keys"
+            : undefined,
+    });
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@ramp-kit/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the LATAM Ramp Kit: lets AI agents explore providers, fetch live ramp quotes, create sandbox orders, simulate PIX/SPEI deposits and inspect Stellar wallets — plus built-in documentation tools covering usage, architecture and the path to production",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ramp-kit-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0",
+    "@ramp-kit/core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "author": "Armando Cruz (https://github.com/armandocodecr)",
+  "homepage": "https://github.com/armandocodecr/latam-ramp-kit#readme",
+  "bugs": {
+    "url": "https://github.com/armandocodecr/latam-ramp-kit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "stellar",
+    "onramp",
+    "latam",
+    "pix",
+    "ramp",
+    "ai-agents",
+    "usdc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/armandocodecr/latam-ramp-kit.git",
+    "directory": "packages/mcp"
+  },
+  "mcpName": "io.github.armandocodecr/ramp-kit",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}