home / mcp / tigerbeetle mcp server

TigerBeetle MCP Server

Provides MCP-based management of TigerBeetle accounts through STDIO with a JSON response format.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jantoniucci-mcp-tiggerbeetle": {
      "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "TB_ADDRESS": "127.0.0.1:3001"
      }
    }
  }
}

You run an MCP (Model Context Protocol) server that manages TigerBeetle accounts. This server provides a JSON-based response format, supports creating accounts with detailed configurations, and integrates with clients like Claude Desktop to streamline account management.

How to use

Connect to the MCP server using an MCP client to create and configure TigerBeetle accounts. You can manage account properties, flags, and related configurations through the client’s MCP interface. Start the MCP server with its standard I/O mode enabled so the client can communicate over STDIO and receive structured responses.

How to install

# Prerequisites
- Java 17 or higher
- Maven 3.8.1 or higher
- TigerBeetle server
- Claude Desktop or any MCP client

# Build and run
export TB_ADDRESS=127.0.0.1:3001

# 1) Build the project
mvn clean package

# 2) Run the MCP server
java -Dspring.ai.mcp.server.stdio=true -jar target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar

Configuration

Set the environment variable TB_ADDRESS to point to your TigerBeetle server. This enables the MCP server to reach TigerBeetle for account management.

Claude Desktop integration

To connect Claude Desktop to the MCP server, add a new MCP Server configuration under Claude Desktop settings. Use the following configuration example in your Claude MCP settings file to start the server from Java.

{
  "mcpServers": {
    "mcp-tiggerbeetle": {
      "command": "[ABSOLUTE PATH TO]/java/current/bin/java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "[ABSOLUTE PATH TO]/mcp-tiggerbeetle/target/mcp-tiggerbeetle-0.0.1-SNAPSHOT.jar"
      ],
      "autoApprove": ["mcp-tiggerbeetle"]
    }
  }
}