BAMM

Model Context Protocol Server for Borrow Automated Market Maker

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "iqaicom-mcp-bamm": {
      "command": "npx",
      "args": [
        "-y",
        "@iqai/mcp-bamm"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

You can manage BAMM positions, lend, borrow, and handle collateral for Fraxtal BAMM contracts through the BAMM MCP Server. By exposing these operations via the Model Context Protocol, you enable large language models to interact with BAMM programmatically from within their context, making it easier to automate DeFi actions and analytics.

How to use

Use an MCP client to connect to the BAMM MCP Server and perform common BAMM-related operations. You can view and manage BAMM positions, lend Fraxswap LP tokens to BAMM contracts to earn yield, borrow against your BAMM collateral, adjust collateral, and retrieve pool statistics. Typical workflows include inspecting your positions, adding or removing collateral, lending LP tokens, borrowing tokens, repaying borrowings, and withdrawing BAMM tokens.

How to install

Prerequisites: ensure you have Node.js and a modern JavaScript runtime installed on your machine.

Install the BAMM MCP Server using the recommended inline command.

# Run the server without global installation
npx @iqai/mcp-bamm

Or build from source if you prefer a local build.

git clone https://github.com/IQAIcom/mcp-bamm.git
cd mcp-bamm
pnpm install
pnpm run build

Additional configuration and usage notes

Security requires you provide a wallet private key to sign transactions. Keep this private key secure and only configure trusted MCP clients.

Configuration and startup options

Minimal configuration to run the server with an MCP client from a local setup is shown below. You can pass the wallet private key through the environment.

{
  "mcpServers": {
    "bamm": {
      "command": "npx",
      "args": ["-y", "@iqai/mcp-bamm"],
      "env": {
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_here"
      }
    }
  }
}

Development

Build and run locally during development to iterate on server changes.

pnpm run build
pnpm run watch

Notes on usage examples

Examples include: viewing BAMM positions, lending LP tokens, borrowing, repaying, adding/removing collateral, and withdrawing BAMM tokens.

MCP Tools

The server provides a set of named tools to interact with BAMM positions and contracts. See the Tools section for details.

Available tools

ADD_COLLATERAL

Add collateral to a BAMM position by specifying the BAMM contract address, amount, and collateral token details.

BORROW

Borrow tokens from a BAMM position by providing the BAMM contract address, amount, and token to borrow.

LEND

Lend Fraxswap LP tokens to a BAMM contract to earn yield, specifying the BAMM contract address and amount.

REMOVE_COLLATERAL

Remove collateral from a BAMM position by specifying the BAMM contract address, amount, and collateral token details.

REPAY

Repay borrowed tokens to a BAMM position by providing the BAMM contract address, amount, and token to repay.

WITHDRAW

Withdraw BAMM tokens from a contract by redeeming BAMM tokens and specifying the BAMM contract address and amount.