{"id":28449445,"url":"https://github.com/iqaicom/mcp-bamm","last_synced_at":"2026-08-27T15:45:59.415Z","repository":{"id":294601491,"uuid":"987449310","full_name":"IQAIcom/mcp-bamm","owner":"IQAIcom","description":"Model Context Protocol Server for Borrow Automated Market Maker","archived":false,"fork":false,"pushed_at":"2026-02-10T10:23:20.000Z","size":162,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-10T15:49:55.797Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@iqai/mcp-bamm","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IQAIcom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-21T05:08:41.000Z","updated_at":"2026-02-10T10:22:55.000Z","dependencies_parsed_at":"2025-06-29T11:08:18.634Z","dependency_job_id":"00e5ef91-7ef4-421a-afdd-d21a9669041c","html_url":"https://github.com/IQAIcom/mcp-bamm","commit_stats":null,"previous_names":["iqaicom/mcp-bamm"],"tags_count":2,"template":false,"template_full_name":"IQAIcom/mcp-server-starter","purl":"pkg:github/IQAIcom/mcp-bamm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fmcp-bamm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fmcp-bamm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fmcp-bamm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fmcp-bamm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IQAIcom","download_url":"https://codeload.github.com/IQAIcom/mcp-bamm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fmcp-bamm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29986241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T21:06:37.093Z","status":"ssl_error","status_checked_at":"2026-03-01T21:05:45.052Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-06T14:08:32.835Z","updated_at":"2026-03-01T22:01:56.879Z","avatar_url":"https://github.com/IQAIcom.png","language":"TypeScript","funding_links":[],"categories":["Finance \u0026 Fintech"],"sub_categories":["How to Submit"],"readme":"# BAMM MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@iqai/mcp-bamm.svg)](https://www.npmjs.com/package/@iqai/mcp-bamm)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Overview\n\nThe BAMM MCP Server enables AI agents to interact with Borrow Automated Market Maker (BAMM) contracts on the Fraxtal blockchain. This server provides comprehensive access to BAMM positions, lending, borrowing, and collateral management operations.\n\nBy implementing the Model Context Protocol (MCP), this server allows Large Language Models (LLMs) to manage BAMM positions, borrow against LP tokens, and perform other operations related to the BAMM protocol directly through their context window.\n\n## Features\n\n*   **Position Management**: View and manage your active BAMM positions across all pools.\n*   **Lending Operations**: Lend Fraxswap LP tokens to BAMM contracts to earn yield.\n*   **Borrowing**: Borrow tokens against your collateral from BAMM positions.\n*   **Collateral Management**: Add or remove collateral from your BAMM positions.\n*   **Pool Analytics**: Access statistics for all BAMM pools.\n\n## Installation\n\n### Using npx (Recommended)\n\nTo use this server without installing it globally:\n\n```bash\nnpx @iqai/mcp-bamm\n```\n\n### Build from Source\n\n```bash\ngit clone https://github.com/IQAIcom/mcp-bamm.git\ncd mcp-bamm\npnpm install\npnpm run build\n```\n\n## Running with an MCP Client\n\nAdd the following configuration to your MCP client settings (e.g., `claude_desktop_config.json`).\n\n### Minimal Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"bamm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@iqai/mcp-bamm\"],\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"your_wallet_private_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Advanced Configuration (Local Build)\n\n```json\n{\n  \"mcpServers\": {\n    \"bamm\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-bamm/dist/index.js\"],\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"your_wallet_private_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Configuration (Environment Variables)\n\n| Variable | Required | Description | Default |\n| :--- | :--- | :--- | :--- |\n| `WALLET_PRIVATE_KEY` | Yes | Private key of the wallet for signing transactions | - |\n\n**Security Note:** Handle your private key with extreme care. Ensure it is stored securely and only provided to trusted MCP client configurations.\n\n## Usage Examples\n\n### Position Management\n*   \"What are my current BAMM positions?\"\n*   \"Show me the stats for all BAMM pools.\"\n\n### Lending \u0026 Borrowing\n*   \"Lend 100 LP tokens to the BAMM at address 0x...\"\n*   \"Borrow 50 FRAX from my BAMM position.\"\n*   \"Repay 25 FRAX to my BAMM position.\"\n\n### Collateral Operations\n*   \"Add 100 FRAX as collateral to my BAMM position.\"\n*   \"Remove 50 USDC collateral from my position.\"\n*   \"Withdraw my LP tokens from the BAMM.\"\n\n## MCP Tools\n\n\u003c!-- AUTO-GENERATED TOOLS START --\u003e\n\n### `ADD_COLLATERAL`\nAdd collateral to your BAMM position\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount of collateral to add |\n| `collateralToken` | string |  | The address of the collateral token |\n| `collateralTokenSymbol` | string |  | The symbol of the collateral token (e.g., 'IQT') |\n\n### `BORROW`\nBorrow tokens from a BAMM position\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount to borrow |\n| `borrowToken` | string |  | The address of the token to borrow |\n| `borrowTokenSymbol` | string |  | The symbol of the token to borrow (e.g., 'IQT') |\n\n### `LEND`\nLend Fraxswap LP tokens to a BAMM contract\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount of LP tokens to lend |\n\n### `REMOVE_COLLATERAL`\nRemove collateral from your BAMM position\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount of collateral to remove |\n| `collateralToken` | string |  | The address of the collateral token |\n| `collateralTokenSymbol` | string |  | The symbol of the collateral token (e.g., 'IQT') |\n\n### `REPAY`\nRepay borrowed tokens to a BAMM position\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount to repay |\n| `borrowToken` | string |  | The address of the token to repay |\n| `borrowTokenSymbol` | string |  | The symbol of the token to repay (e.g., 'IQT') |\n\n### `WITHDRAW`\nWithdraw LP tokens from a BAMM contract by redeeming BAMM tokens\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `bammAddress` | string | Yes | The address of the BAMM contract |\n| `amount` | string | Yes | The amount of BAMM tokens to withdraw |\n\n\u003c!-- AUTO-GENERATED TOOLS END --\u003e\n\n## Development\n\n### Build Project\n```bash\npnpm run build\n```\n\n### Development Mode (Watch)\n```bash\npnpm run watch\n```\n\n### Linting \u0026 Formatting\n```bash\npnpm run lint\npnpm run format\n```\n\n### Project Structure\n*   `src/tools/`: Individual tool definitions\n*   `src/services/`: API client and business logic\n*   `src/lib/`: Shared utilities\n*   `src/index.ts`: Server entry point\n\n## Resources\n\n*   [BAMM Documentation](https://docs.frax.finance/frax-lending/bamm)\n*   [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\n*   [Fraxtal Network](https://frax.finance)\n\n## Disclaimer\n\nThis project interacts with blockchain smart contracts and handles cryptocurrency transactions. Users should exercise caution, verify all data independently, and understand the risks involved in DeFi operations.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiqaicom%2Fmcp-bamm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiqaicom%2Fmcp-bamm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiqaicom%2Fmcp-bamm/lists"}