{"_id":"@breezebaby/mcp-server","_rev":"3-c52021bdd023b895323b79cd6fbc07c8","name":"@breezebaby/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@breezebaby/mcp-server","version":"1.0.0","_id":"@breezebaby/mcp-server@1.0.0","maintainers":[{"name":"_austbot","email":"me@austbot.com"},{"name":"nicknutdotsol","email":"playl2573@gmail.com"}],"bin":{"breeze-mcp":"dist/index.js"},"dist":{"shasum":"7f7a5878e64a8cb0b311c5bf03ca52612818e070","tarball":"https://registry.npmjs.org/@breezebaby/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":26,"integrity":"sha512-N6RMIAohWoG5dXs8gdLXOU7yzkxUf9pDtD+B7iTUneaGfV5dcL78bq1IQ5eQP0WttL9iOyUEAekEV8sEEGt0ZQ==","signatures":[{"sig":"MEUCIQCkWqi7KXWorP4JV5Q5mSkiKuS7T2kBtlTnDf3CdpXTdAIgUnrDUh0xXGvYuMFS52TnKIAKLaZsrblxzATjEENwK9o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2298195},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"3ae6d2862051761f6593dbc7bf0cdef1237c199e","scripts":{"dev":"bun --watch src/index.ts","test":"node --test","build":"bun build src/index.ts --outdir dist --target node && printf '#!/usr/bin/env node\\n' | cat - dist/index.js > dist/tmp && mv dist/tmp dist/index.js","check":"tsc --noEmit","start":"bun dist/index.js","prepublishOnly":"bun run build"},"_npmUser":{"name":"nicknutdotsol","email":"playl2573@gmail.com"},"_npmVersion":"10.9.0","description":"Breeze yield aggregator MCP server for Claude and other AI agents","directories":{},"_nodeVersion":"22.9.0","dependencies":{"zod":"^4.3.6","bs58":"^6.0.0","dotenv":"^17.3.1","@solana/web3.js":"^1.98.4","@breezebaby/breeze-sdk":"^2.0.3","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.3","@types/node":"^22.13.10"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1771373476000_0.46781127537076417","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-02-18T00:11:15.775Z","modified":"2026-07-24T16:00:57.473Z","1.0.0":"2026-02-18T00:11:16.182Z"},"description":"Breeze yield aggregator MCP server for Claude and other AI agents","maintainers":[{"email":"tracy@tracycodes.com","name":"tracycodes"},{"email":"keegan.thompson@solana.org","name":"keeganthomp"},{"email":"me@austbot.com","name":"_austbot"},{"email":"playl2573@gmail.com","name":"nicknutdotsol"}],"readme":"# mcp\n\nMCP server (stdio) for Breeze strategy operations on Solana.\n\nThis service exposes Breeze tools to MCP clients (for example Cursor) and handles:\n\n- Strategy info and APY lookup\n- Balance/position checks for the configured wallet\n- Unsigned deposit/withdraw transaction creation\n- Local signing + broadcast for returned transactions\n\n## Environment\n\nCreate `apps/mcp/.env` with:\n\n```bash\nBREEZE_API_KEY=...\nWALLET_PRIVATE_KEY=... # base58-encoded secret key\n# Optional:\nBREEZE_STRATEGY_ID=43620ba3-354c-456b-aa3c-5bf7fa46a6d4\nSOLANA_RPC_URL=https://api.mainnet-beta.solana.com\n```\n\nRequired:\n\n- `BREEZE_API_KEY`\n- `WALLET_PRIVATE_KEY`\n\nOptional:\n\n- `BREEZE_STRATEGY_ID` (defaults to the strategy above)\n- `SOLANA_RPC_URL` (defaults to Solana mainnet public RPC)\n\n## Tools\n\n- `get_strategy_info` - returns strategy metadata and APY breakdown\n- `check_balances` - returns current Breeze positions for the configured wallet\n- `get_deposit_tx` - creates an unsigned base64 deposit transaction\n- `get_withdraw_tx` - creates an unsigned base64 withdraw transaction\n- `sign_and_send_tx` - signs and sends a base64 transaction\n\n## Project Structure\n\n- `src/index.ts` - MCP server bootstrap and transport wiring\n- `src/tools/register-breeze-tools.ts` - Breeze MCP tool registration/handlers\n- `src/lib/config.ts` - env/config loading and SDK/connection setup\n- `src/lib/tokens.ts` - token metadata and symbol/mint resolution\n- `src/lib/amounts.ts` - amount conversion and formatting helpers\n- `src/lib/results.ts` - common MCP text/json/error response helpers\n\n## Development\n\nFrom this directory:\n\n```bash\nbun run dev\n```\n\nOr from the repo root:\n\n```bash\nbun run --filter mcp dev\n```\n\n## Scripts\n\n- `bun run dev` - run with Bun watch mode\n- `bun run build` - compile TypeScript to `dist`\n- `bun run start` - run compiled MCP stdio server\n- `bun run check` - TypeScript no-emit check\n- `bun run test` - Node test runner\n\n## Test With Claude Desktop (Local)\n\n1. Create env file:\n\n```bash\ncp .env.example .env\n```\n\n2. Fill required values in `apps/mcp/.env`:\n\n- `BREEZE_API_KEY`\n- `WALLET_PRIVATE_KEY`\n\n3. Build once:\n\n```bash\nbun run build\n```\n\n4. Get your Node binary path:\n\n```bash\nwhich node\n```\n\nUse that exact absolute path in Claude config.\n\n5. Add this MCP server to Claude Desktop config (macOS):\n   `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n```json\n\"breeze\": {\n      \"command\": \"node\",\n      \"args\": [\"-y\", \"@breezebaby/mcp-server\"],\n      \"env\": {\n        \"BREEZE_API_KEY\": \"your-breeze-api-key\",\n        \"BREEZE_STRATEGY_ID\": \"strategy-id\",\n        \"WALLET_PRIVATE_KEY\": \"your-private-key\",\n        \"SOLANA_RPC_URL\": \"https://api.mainnet-beta.solana.com\"\n      }\n}\n```\n\n6. Restart Claude Desktop.\n\n7. In Claude, run a quick smoke test prompt, for example:\n\n- \"Use `get_strategy_info`.\"\n- \"Use `check_balances` for my configured wallet.\"\n\nIf tools do not appear:\n\n- Confirm `command` matches `which node`.\n- Confirm `DOTENV_CONFIG_PATH` points to your real `.env` file.\n- Confirm `bun run build` was run and `dist/index.js` exists.\n- Avoid `dev` for Claude MCP.\n","readmeFilename":"README.md"}