@codespar/mcp-foxbit 0.2.0 → 0.2.2

package/README.md

@@ -51,20 +51,31 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `list_markets` | List all available trading pairs |
-| `get_ticker` | Get 24h ticker data for a market |
-| `get_orderbook` | Get order book for a market |
-| `get_account_balances` | Get account balances |
-| `create_order` | Create a buy or sell order (limit/market) |
+## Tools (21)
+
+| Tool | Purpose |
+|---|---|
+| `list_markets` | List all available trading pairs / markets on Foxbit |
+| `list_currencies` | List all supported currencies (crypto and fiat) on Foxbit |
+| `get_currency` | Get details of a specific currency (precision, min/max amounts, type) |
+| `get_ticker` | Get 24h ticker data for a market (price, volume, high/low) |
+| `get_orderbook` | Get order book (bids and asks) for a market |
+| `get_market_trades` | Get recent public trades for a market (trade history / tape) |
+| `get_candles` | Get OHLC candlestick data for a market |
+| `get_account_balances` | Get account balances for all currencies |
+| `get_balance` | Get account balance for a single currency |
+| `create_order` | Create a buy or sell order (limit or market) |
 | `get_order` | Get order details by ID |
-| `list_orders` | List orders with filters |
-| `cancel_order` | Cancel an open order |
-| `list_trades` | List executed trades |
-| `list_deposits_withdrawals` | List deposits and withdrawals for a currency |
+| `list_orders` | List orders with optional filters |
+| `cancel_order` | Cancel an open order by ID |
+| `list_trades` | List user's executed trades (private trade history) |
+| `list_deposits_withdrawals` | List deposits and withdrawals (transactions) for a currency |
+| `create_pix_deposit` | Create a Pix instant deposit (BRL). |
+| `list_pix_deposits` | List Pix deposit history (BRL instant deposits) |
+| `create_pix_withdrawal` | Create a Pix withdrawal (BRL) to a Pix key |
+| `list_pix_withdrawals` | List Pix withdrawal history (BRL fiat withdrawals) |
+| `create_crypto_withdrawal` | Create a crypto withdrawal to an external wallet address |
+| `get_trading_fees` | Get current trading fees and limits (maker/taker per pair, withdrawal limits) |
 
 ## Authentication
 
@@ -112,13 +123,13 @@ Merchants and traders use both for best execution and redundancy.
 - Institutional / OTC desk integrations
 - WebSocket market data streams (where MCP transport allows)
 
-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
 
 - [Foxbit Website](https://foxbit.com.br)
 - [Foxbit API Documentation](https://docs.foxbit.com.br)
-- [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

@@ -62,7 +62,10 @@ async function foxbitRequest(method, path, query, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-foxbit", 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-foxbit", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -390,7 +393,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-foxbit", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-foxbit", 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-foxbit",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Foxbit — Brazilian crypto exchange, trading, orderbook, institutional",
   "type": "module",
   "main": "./dist/index.js",

package/server.json

@@ -3,16 +3,16 @@
   "name": "io.github.codespar/mcp-foxbit",
   "description": "MCP server for Foxbit — Brazilian crypto exchange, trading, orderbook, institutional",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/crypto/foxbit"
   },
-  "version": "0.2.0",
+  "version": "0.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-foxbit",
-      "version": "0.2.0",
+      "version": "0.2.2",
       "transport": {
         "type": "stdio"
       },
@@ -33,5 +33,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.foxbit.com.br",
+    "logoUrl": "https://logo.clearbit.com/foxbit.com.br",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=foxbit.com.br&sz=128",
+    "docsUrl": "https://docs.foxbit.com.br",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -77,9 +77,14 @@ async function foxbitRequest(
   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-foxbit", version: "0.2.0" },
-  { capabilities: { tools: {} } },
+  { name: "mcp-foxbit", version: "0.2.1" },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT },
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -407,7 +412,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-foxbit", 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-foxbit", 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 });