@codespar/mcp-circle 0.2.0 → 0.2.2

package/README.md

@@ -49,19 +49,32 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
+## Tools (23)
 
-| Tool | Description |
-|------|-------------|
-| `create_wallet` | Create a new Circle wallet |
+| Tool | Purpose |
+|---|---|
+| `create_wallet` | Create a new Circle business-account wallet |
 | `get_wallet` | Get wallet details by ID |
+| `list_wallets` | List all Circle wallets |
 | `create_payment` | Accept a USDC payment via Circle |
 | `get_payment` | Get payment details by ID |
 | `create_payout` | Create a payout from Circle (USDC to fiat) |
 | `get_payout` | Get payout details by ID |
-| `create_transfer` | Create a USDC transfer between Circle wallets |
+| `list_payouts` | List payouts with optional filters |
+| `create_transfer` | Create a USDC transfer between Circle wallets (or to blockchain address) |
 | `get_transfer` | Get transfer details by ID |
-| `get_balance` | Get account balance |
+| `list_transfers` | List transfers with optional filters |
+| `create_card` | Register card data for on-ramp payments |
+| `get_card` | Get card details by ID |
+| `list_cards` | List registered cards |
+| `list_settlements` | List settlements (card payment batches) |
+| `get_settlement` | Get settlement details by ID |
+| `list_chargebacks` | List chargebacks |
+| `get_chargeback` | Get chargeback details by ID |
+| `create_subscription` | Register a notification subscription (webhook) |
+| `list_subscriptions` | List notification subscriptions (webhooks) |
+| `delete_subscription` | Delete a notification subscription |
+| `get_balance` | Get business-account balance |
 | `list_transactions` | List transactions with optional filters |
 
 ## Authentication
@@ -98,13 +111,13 @@ Circle provides a sandbox at `api-sandbox.circle.com`. Use a sandbox API key for
 - `smart_contract_calls` — Execute smart contract calls
 - `cross_chain_transfers` — Transfer assets across blockchains
 
-Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-brasil) or [request a tool](https://github.com/codespar/mcp-dev-brasil/issues).
+Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).
 
 ## Links
 
 - [Circle Website](https://circle.com)
 - [Circle API Documentation](https://developers.circle.com)
-- [MCP Dev Brasil](https://github.com/codespar/mcp-dev-brasil)
+- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)
 - [Landing Page](https://codespar.dev/mcp)
 
 ## Enterprise

package/dist/index.js

@@ -52,7 +52,10 @@ async function circleRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-circle", version: "0.2.0" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-circle", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 const amountSchema = {
     type: "object",
     properties: {
@@ -444,7 +447,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-circle", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-circle", version: "0.2.1" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/mcp-circle",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Circle — USDC payments, wallets, payouts, transfers, cards, settlements, chargebacks, webhooks",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -3,16 +3,16 @@
   "name": "io.github.codespar/mcp-circle",
   "description": "MCP server for Circle — USDC payments, wallets, payouts, transfers",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/crypto/circle"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-circle",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -26,5 +26,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.circle.com",
+    "logoUrl": "https://logo.clearbit.com/circle.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=circle.com&sz=128",
+    "docsUrl": "https://developers.circle.com",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/__tests__/index.test.ts

@@ -32,9 +32,9 @@ beforeEach(async () => {
 });
 
 describe("mcp-circle", () => {
-  it("should register 10 tools", async () => {
+  it("should register 23 tools", async () => {
     const result = await listToolsHandler();
-    expect(result.tools).toHaveLength(10);
+    expect(result.tools).toHaveLength(23);
   });
 
   it("should call correct API endpoint for create_wallet", async () => {
@@ -43,7 +43,7 @@ describe("mcp-circle", () => {
     await callToolHandler({ params: { name: "create_wallet", arguments: { idempotencyKey: "key1" } } });
 
     const [url, opts] = mockFetch.mock.calls[0];
-    expect(url).toContain("api.circle.com/v1/wallets");
+    expect(url).toContain("api.circle.com/v1/businessAccount/wallets");
     expect(opts.method).toBe("POST");
     expect(opts.headers.Authorization).toBe("Bearer test-key");
   });

package/src/index.ts

@@ -60,9 +60,14 @@ async function circleRequest(method: string, path: string, body?: unknown): Prom
   return res.json();
 }
 
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT =
+  "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+
 const server = new Server(
-  { name: "mcp-circle", version: "0.2.0" },
-  { capabilities: { tools: {} } }
+  { name: "mcp-circle", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT }
 );
 
 const amountSchema = {
@@ -474,7 +479,7 @@ async function main() {
       if (!sid && isInitializeRequest(req.body)) {
         const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
         t.onclose = () => { if (t.sessionId) transports.delete(t.sessionId); };
-        const s = new Server({ name: "mcp-circle", version: "0.2.0" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
+        const s = new Server({ name: "mcp-circle", version: "0.2.1" }, { capabilities: { tools: {} } }); (server as any)._requestHandlers.forEach((v: any, k: any) => (s as any)._requestHandlers.set(k, v)); (server as any)._notificationHandlers?.forEach((v: any, k: any) => (s as any)._notificationHandlers.set(k, v)); await s.connect(t);
         await t.handleRequest(req, res, req.body); return;
       }
       res.status(400).json({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request" }, id: null });