@codespar/mcp-foxbit 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# @codespar/mcp-foxbit
+
+> MCP server for **Foxbit** — Brazilian cryptocurrency exchange with trading, orderbook, and market data
+
+[![npm](https://img.shields.io/npm/v/@codespar/mcp-foxbit)](https://www.npmjs.com/package/@codespar/mcp-foxbit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Start
+
+### Claude Desktop
+
+Add to `~/.config/claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "foxbit": {
+      "command": "npx",
+      "args": ["-y", "@codespar/mcp-foxbit"],
+      "env": {
+        "FOXBIT_API_KEY": "your-key",
+        "FOXBIT_API_SECRET": "your-secret"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add foxbit -- npx @codespar/mcp-foxbit
+```
+
+### Cursor / VS Code
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "foxbit": {
+      "command": "npx",
+      "args": ["-y", "@codespar/mcp-foxbit"],
+      "env": {
+        "FOXBIT_API_KEY": "your-key",
+        "FOXBIT_API_SECRET": "your-secret"
+      }
+    }
+  }
+}
+```
+
+## 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) |
+| `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 |
+
+## Authentication
+
+Foxbit uses HMAC-SHA256 request signing. Each request includes three headers:
+
+- `X-FB-ACCESS-KEY` — API key
+- `X-FB-ACCESS-TIMESTAMP` — UNIX timestamp in milliseconds
+- `X-FB-ACCESS-SIGNATURE` — hex HMAC-SHA256 of `timestamp + method + path + queryString + body` using API secret
+
+Base URL: `https://api.foxbit.com.br/rest/v3`
+
+### Get your credentials
+
+1. Go to [Foxbit](https://app.foxbit.com.br)
+2. Create an account (KYC required for Brazilian residents)
+3. Navigate to API settings to generate key and secret
+4. Set the environment variables
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FOXBIT_API_KEY` | Yes | API key from Foxbit |
+| `FOXBIT_API_SECRET` | Yes | API secret for HMAC-SHA256 |
+
+## Brazilian Crypto Exchanges in CodeSpar
+
+Hedge liquidity across multiple BR venues:
+
+- **[Mercado Bitcoin](../mercado-bitcoin)** — biggest BR exchange, 200+ tokens, deep altcoin coverage
+- **Foxbit (this)** — 2nd BR exchange, focus on BTC / ETH / LTC, strong institutional desk
+
+Merchants and traders use both for best execution and redundancy.
+
+## Roadmap
+
+### v0.2 (planned)
+- `get_candles` — OHLCV candlestick data
+- `create_withdrawal` — Initiate crypto/PIX withdrawal
+- `list_currencies` — Available currencies and networks
+- `get_fees` — Trading fees for account tier
+- `create_stop_order` — Stop-limit / stop-market orders
+
+### v0.3 (planned)
+- 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).
+
+## 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)
+- [Landing Page](https://codespar.dev/mcp)
+
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for Foxbit — Brazilian cryptocurrency exchange.
+ *
+ * Tools:
+ * - 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)
+ * - 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
+ *
+ * Environment:
+ *   FOXBIT_API_KEY — API key from https://app.foxbit.com.br/
+ *   FOXBIT_API_SECRET — API secret for HMAC-SHA256 signature
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as crypto from "node:crypto";
+const API_KEY = process.env.FOXBIT_API_KEY || "";
+const API_SECRET = process.env.FOXBIT_API_SECRET || "";
+const BASE_URL = "https://api.foxbit.com.br";
+const PATH_PREFIX = "/rest/v3";
+async function foxbitRequest(method, path, query, body) {
+    const timestamp = Date.now().toString();
+    const bodyStr = body ? JSON.stringify(body) : "";
+    const params = new URLSearchParams();
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== null && v !== "")
+                params.set(k, String(v));
+        }
+    }
+    const queryString = params.toString();
+    const fullPath = `${PATH_PREFIX}${path}`;
+    const prehash = timestamp + method.toUpperCase() + fullPath + queryString + bodyStr;
+    const signature = crypto.createHmac("sha256", API_SECRET).update(prehash).digest("hex");
+    const url = `${BASE_URL}${fullPath}${queryString ? `?${queryString}` : ""}`;
+    const res = await fetch(url, {
+        method,
+        headers: {
+            "Content-Type": "application/json",
+            "X-FB-ACCESS-KEY": API_KEY,
+            "X-FB-ACCESS-TIMESTAMP": timestamp,
+            "X-FB-ACCESS-SIGNATURE": signature,
+        },
+        body: bodyStr || undefined,
+    });
+    if (!res.ok) {
+        const err = await res.text();
+        throw new Error(`Foxbit API ${res.status}: ${err}`);
+    }
+    return res.json();
+}
+const server = new Server({ name: "mcp-foxbit", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "list_markets",
+            description: "List all available trading pairs / markets on Foxbit",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "get_ticker",
+            description: "Get 24h ticker data for a market (price, volume, high/low)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    symbol: { type: "string", description: "Market symbol (e.g. btcbrl, ethbrl, ltcbrl)" },
+                },
+                required: ["symbol"],
+            },
+        },
+        {
+            name: "get_orderbook",
+            description: "Get order book (bids and asks) for a market",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    symbol: { type: "string", description: "Market symbol (e.g. btcbrl)" },
+                    depth: { type: "number", description: "Number of price levels per side" },
+                },
+                required: ["symbol"],
+            },
+        },
+        {
+            name: "get_account_balances",
+            description: "Get account balances for all currencies",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "create_order",
+            description: "Create a buy or sell order (limit or market)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    market_symbol: { type: "string", description: "Market symbol (e.g. btcbrl)" },
+                    side: { type: "string", enum: ["BUY", "SELL"], description: "Order side" },
+                    type: { type: "string", enum: ["LIMIT", "MARKET", "STOP_LIMIT", "STOP_MARKET"], description: "Order type" },
+                    quantity: { type: "string", description: "Base asset quantity (e.g. BTC)" },
+                    price: { type: "string", description: "Limit price (required for LIMIT orders)" },
+                    client_order_id: { type: "string", description: "Client-supplied order ID" },
+                    time_in_force: { type: "string", enum: ["GTC", "IOC", "FOK"], description: "Time in force" },
+                },
+                required: ["market_symbol", "side", "type", "quantity"],
+            },
+        },
+        {
+            name: "get_order",
+            description: "Get order details by ID",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string", description: "Order ID" },
+                },
+                required: ["id"],
+            },
+        },
+        {
+            name: "list_orders",
+            description: "List orders with optional filters",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    market_symbol: { type: "string", description: "Filter by market symbol" },
+                    state: { type: "string", enum: ["ACTIVE", "FILLED", "CANCELED", "PARTIALLY_FILLED", "PARTIALLY_CANCELED"], description: "Filter by order state" },
+                    side: { type: "string", enum: ["BUY", "SELL"], description: "Filter by side" },
+                    start_time: { type: "string", description: "Start time (ISO 8601)" },
+                    end_time: { type: "string", description: "End time (ISO 8601)" },
+                    page_size: { type: "number", description: "Results per page" },
+                    page: { type: "number", description: "Page number" },
+                },
+            },
+        },
+        {
+            name: "cancel_order",
+            description: "Cancel an open order by ID",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string", description: "Order ID to cancel" },
+                },
+                required: ["id"],
+            },
+        },
+        {
+            name: "list_trades",
+            description: "List user's executed trades",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    market_symbol: { type: "string", description: "Filter by market symbol" },
+                    start_time: { type: "string", description: "Start time (ISO 8601)" },
+                    end_time: { type: "string", description: "End time (ISO 8601)" },
+                    page_size: { type: "number", description: "Results per page" },
+                    page: { type: "number", description: "Page number" },
+                },
+            },
+        },
+        {
+            name: "list_deposits_withdrawals",
+            description: "List deposits and withdrawals (transactions) for a currency",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    currency_symbol: { type: "string", description: "Currency symbol (e.g. brl, btc, eth)" },
+                    type: { type: "string", enum: ["deposit", "withdraw"], description: "Filter by transaction type" },
+                    start_time: { type: "string", description: "Start time (ISO 8601)" },
+                    end_time: { type: "string", description: "End time (ISO 8601)" },
+                    page_size: { type: "number", description: "Results per page" },
+                    page: { type: "number", description: "Page number" },
+                },
+                required: ["currency_symbol"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "list_markets":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/markets"), null, 2) }] };
+            case "get_ticker":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/markets/${args?.symbol}/ticker/24hr`), null, 2) }] };
+            case "get_orderbook":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/markets/${args?.symbol}/orderbook`, { depth: args?.depth }), null, 2) }] };
+            case "get_account_balances":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/accounts"), null, 2) }] };
+            case "create_order":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("POST", "/orders", undefined, args), null, 2) }] };
+            case "get_order":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/orders/${args?.id}`), null, 2) }] };
+            case "list_orders":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/orders", args), null, 2) }] };
+            case "cancel_order":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("DELETE", `/orders/${args?.id}`), null, 2) }] };
+            case "list_trades":
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/trades", args), null, 2) }] };
+            case "list_deposits_withdrawals": {
+                const { currency_symbol, ...rest } = (args || {});
+                return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/accounts/${currency_symbol}/transactions`, rest), null, 2) }] };
+            }
+            default:
+                return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+        }
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+    }
+});
+async function main() {
+    if (process.argv.includes("--http") || process.env.MCP_HTTP === "true") {
+        const { default: express } = await import("express");
+        const { randomUUID } = await import("node:crypto");
+        const app = express();
+        app.use(express.json());
+        const transports = new Map();
+        app.get("/health", (_req, res) => res.json({ status: "ok", sessions: transports.size }));
+        app.post("/mcp", async (req, res) => {
+            const sid = req.headers["mcp-session-id"];
+            if (sid && transports.has(sid)) {
+                await transports.get(sid).handleRequest(req, res, req.body);
+                return;
+            }
+            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.1.0" }, { 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);
+                await t.handleRequest(req, res, req.body);
+                return;
+            }
+            res.status(400).json({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request" }, id: null });
+        });
+        app.get("/mcp", async (req, res) => { const sid = req.headers["mcp-session-id"]; if (sid && transports.has(sid))
+            await transports.get(sid).handleRequest(req, res);
+        else
+            res.status(400).send("Invalid session"); });
+        app.delete("/mcp", async (req, res) => { const sid = req.headers["mcp-session-id"]; if (sid && transports.has(sid))
+            await transports.get(sid).handleRequest(req, res);
+        else
+            res.status(400).send("Invalid session"); });
+        const port = Number(process.env.MCP_PORT) || 3000;
+        app.listen(port, () => { console.error(`MCP HTTP server on http://localhost:${port}/mcp`); });
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@codespar/mcp-foxbit",
+  "version": "0.1.0",
+  "description": "MCP server for Foxbit — Brazilian crypto exchange, trading, orderbook, institutional",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-foxbit": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "foxbit",
+    "crypto",
+    "exchange",
+    "trading",
+    "brazil"
+  ],
+  "mcpName": "io.github.codespar/mcp-foxbit"
+}

package/server.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "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",
+    "source": "github",
+    "subfolder": "packages/crypto/foxbit"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@codespar/mcp-foxbit",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "FOXBIT_API_KEY",
+          "description": "API key for Foxbit",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "FOXBIT_API_SECRET",
+          "description": "API secret for Foxbit HMAC-SHA256 signature",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}

package/src/index.ts

@@ -0,0 +1,269 @@
+#!/usr/bin/env node
+
+/**
+ * MCP Server for Foxbit — Brazilian cryptocurrency exchange.
+ *
+ * Tools:
+ * - 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)
+ * - 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
+ *
+ * Environment:
+ *   FOXBIT_API_KEY — API key from https://app.foxbit.com.br/
+ *   FOXBIT_API_SECRET — API secret for HMAC-SHA256 signature
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import * as crypto from "node:crypto";
+
+const API_KEY = process.env.FOXBIT_API_KEY || "";
+const API_SECRET = process.env.FOXBIT_API_SECRET || "";
+const BASE_URL = "https://api.foxbit.com.br";
+const PATH_PREFIX = "/rest/v3";
+
+async function foxbitRequest(
+  method: string,
+  path: string,
+  query?: Record<string, string | number | boolean | undefined>,
+  body?: unknown,
+): Promise<unknown> {
+  const timestamp = Date.now().toString();
+  const bodyStr = body ? JSON.stringify(body) : "";
+
+  const params = new URLSearchParams();
+  if (query) {
+    for (const [k, v] of Object.entries(query)) {
+      if (v !== undefined && v !== null && v !== "") params.set(k, String(v));
+    }
+  }
+  const queryString = params.toString();
+  const fullPath = `${PATH_PREFIX}${path}`;
+
+  const prehash = timestamp + method.toUpperCase() + fullPath + queryString + bodyStr;
+  const signature = crypto.createHmac("sha256", API_SECRET).update(prehash).digest("hex");
+
+  const url = `${BASE_URL}${fullPath}${queryString ? `?${queryString}` : ""}`;
+  const res = await fetch(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      "X-FB-ACCESS-KEY": API_KEY,
+      "X-FB-ACCESS-TIMESTAMP": timestamp,
+      "X-FB-ACCESS-SIGNATURE": signature,
+    },
+    body: bodyStr || undefined,
+  });
+  if (!res.ok) {
+    const err = await res.text();
+    throw new Error(`Foxbit API ${res.status}: ${err}`);
+  }
+  return res.json();
+}
+
+const server = new Server(
+  { name: "mcp-foxbit", version: "0.1.0" },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "list_markets",
+      description: "List all available trading pairs / markets on Foxbit",
+      inputSchema: { type: "object", properties: {} },
+    },
+    {
+      name: "get_ticker",
+      description: "Get 24h ticker data for a market (price, volume, high/low)",
+      inputSchema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Market symbol (e.g. btcbrl, ethbrl, ltcbrl)" },
+        },
+        required: ["symbol"],
+      },
+    },
+    {
+      name: "get_orderbook",
+      description: "Get order book (bids and asks) for a market",
+      inputSchema: {
+        type: "object",
+        properties: {
+          symbol: { type: "string", description: "Market symbol (e.g. btcbrl)" },
+          depth: { type: "number", description: "Number of price levels per side" },
+        },
+        required: ["symbol"],
+      },
+    },
+    {
+      name: "get_account_balances",
+      description: "Get account balances for all currencies",
+      inputSchema: { type: "object", properties: {} },
+    },
+    {
+      name: "create_order",
+      description: "Create a buy or sell order (limit or market)",
+      inputSchema: {
+        type: "object",
+        properties: {
+          market_symbol: { type: "string", description: "Market symbol (e.g. btcbrl)" },
+          side: { type: "string", enum: ["BUY", "SELL"], description: "Order side" },
+          type: { type: "string", enum: ["LIMIT", "MARKET", "STOP_LIMIT", "STOP_MARKET"], description: "Order type" },
+          quantity: { type: "string", description: "Base asset quantity (e.g. BTC)" },
+          price: { type: "string", description: "Limit price (required for LIMIT orders)" },
+          client_order_id: { type: "string", description: "Client-supplied order ID" },
+          time_in_force: { type: "string", enum: ["GTC", "IOC", "FOK"], description: "Time in force" },
+        },
+        required: ["market_symbol", "side", "type", "quantity"],
+      },
+    },
+    {
+      name: "get_order",
+      description: "Get order details by ID",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Order ID" },
+        },
+        required: ["id"],
+      },
+    },
+    {
+      name: "list_orders",
+      description: "List orders with optional filters",
+      inputSchema: {
+        type: "object",
+        properties: {
+          market_symbol: { type: "string", description: "Filter by market symbol" },
+          state: { type: "string", enum: ["ACTIVE", "FILLED", "CANCELED", "PARTIALLY_FILLED", "PARTIALLY_CANCELED"], description: "Filter by order state" },
+          side: { type: "string", enum: ["BUY", "SELL"], description: "Filter by side" },
+          start_time: { type: "string", description: "Start time (ISO 8601)" },
+          end_time: { type: "string", description: "End time (ISO 8601)" },
+          page_size: { type: "number", description: "Results per page" },
+          page: { type: "number", description: "Page number" },
+        },
+      },
+    },
+    {
+      name: "cancel_order",
+      description: "Cancel an open order by ID",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Order ID to cancel" },
+        },
+        required: ["id"],
+      },
+    },
+    {
+      name: "list_trades",
+      description: "List user's executed trades",
+      inputSchema: {
+        type: "object",
+        properties: {
+          market_symbol: { type: "string", description: "Filter by market symbol" },
+          start_time: { type: "string", description: "Start time (ISO 8601)" },
+          end_time: { type: "string", description: "End time (ISO 8601)" },
+          page_size: { type: "number", description: "Results per page" },
+          page: { type: "number", description: "Page number" },
+        },
+      },
+    },
+    {
+      name: "list_deposits_withdrawals",
+      description: "List deposits and withdrawals (transactions) for a currency",
+      inputSchema: {
+        type: "object",
+        properties: {
+          currency_symbol: { type: "string", description: "Currency symbol (e.g. brl, btc, eth)" },
+          type: { type: "string", enum: ["deposit", "withdraw"], description: "Filter by transaction type" },
+          start_time: { type: "string", description: "Start time (ISO 8601)" },
+          end_time: { type: "string", description: "End time (ISO 8601)" },
+          page_size: { type: "number", description: "Results per page" },
+          page: { type: "number", description: "Page number" },
+        },
+        required: ["currency_symbol"],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "list_markets":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/markets"), null, 2) }] };
+      case "get_ticker":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/markets/${args?.symbol}/ticker/24hr`), null, 2) }] };
+      case "get_orderbook":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/markets/${args?.symbol}/orderbook`, { depth: args?.depth as number | undefined }), null, 2) }] };
+      case "get_account_balances":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/accounts"), null, 2) }] };
+      case "create_order":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("POST", "/orders", undefined, args), null, 2) }] };
+      case "get_order":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/orders/${args?.id}`), null, 2) }] };
+      case "list_orders":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/orders", args as Record<string, string | number | undefined>), null, 2) }] };
+      case "cancel_order":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("DELETE", `/orders/${args?.id}`), null, 2) }] };
+      case "list_trades":
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", "/trades", args as Record<string, string | number | undefined>), null, 2) }] };
+      case "list_deposits_withdrawals": {
+        const { currency_symbol, ...rest } = (args || {}) as Record<string, string | number | undefined>;
+        return { content: [{ type: "text", text: JSON.stringify(await foxbitRequest("GET", `/accounts/${currency_symbol}/transactions`, rest), null, 2) }] };
+      }
+      default:
+        return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+    }
+  } catch (err) {
+    return { content: [{ type: "text", text: `Error: ${err instanceof Error ? err.message : String(err)}` }], isError: true };
+  }
+});
+
+async function main() {
+  if (process.argv.includes("--http") || process.env.MCP_HTTP === "true") {
+    const { default: express } = await import("express");
+    const { randomUUID } = await import("node:crypto");
+    const app = express();
+    app.use(express.json());
+    const transports = new Map<string, StreamableHTTPServerTransport>();
+    app.get("/health", (_req: any, res: any) => res.json({ status: "ok", sessions: transports.size }));
+    app.post("/mcp", async (req: any, res: any) => {
+      const sid = req.headers["mcp-session-id"] as string | undefined;
+      if (sid && transports.has(sid)) { await transports.get(sid)!.handleRequest(req, res, req.body); return; }
+      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.1.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);
+        await t.handleRequest(req, res, req.body); return;
+      }
+      res.status(400).json({ jsonrpc: "2.0", error: { code: -32000, message: "Bad Request" }, id: null });
+    });
+    app.get("/mcp", async (req: any, res: any) => { const sid = req.headers["mcp-session-id"] as string; if (sid && transports.has(sid)) await transports.get(sid)!.handleRequest(req, res); else res.status(400).send("Invalid session"); });
+    app.delete("/mcp", async (req: any, res: any) => { const sid = req.headers["mcp-session-id"] as string; if (sid && transports.has(sid)) await transports.get(sid)!.handleRequest(req, res); else res.status(400).send("Invalid session"); });
+    const port = Number(process.env.MCP_PORT) || 3000;
+    app.listen(port, () => { console.error(`MCP HTTP server on http://localhost:${port}/mcp`); });
+  } else {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+  }
+}
+
+main().catch(console.error);

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "declaration": true
+  },
+  "include": ["src"]
+}