@gitbank/mcp

MCP server for Gitbank — exposes vault balances, transaction history, and project budgets on Base L2 to any MCP-compatible AI assistant.

Works with Claude Desktop, IBM watsonx.ai, Cursor, VS Code Copilot, and any other MCP client.

Remote server

Connect directly to the hosted server, no installation needed:

https://gitbank.io/api/mcp

Claude Desktop

~/.config/claude/claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gitbank": {
      "type": "http",
      "url": "https://gitbank.io/api/mcp"
    }
  }
}

IBM watsonx.ai / IBM Bob

{
  "mcpServers": {
    "gitbank": {
      "type": "http",
      "url": "https://gitbank.io/api/mcp"
    }
  }
}

Cursor / VS Code

{
  "gitbank": {
    "url": "https://gitbank.io/api/mcp"
  }
}

Tools

Tool	Description
get_vault_balance	WETH and USDC locked balance for a GitHub user on Base mainnet
get_transactions	Recent on-chain transactions: deposits, withdrawals, swaps, bounties
get_project_status	Project budget, spent amount, remaining budget, and all task bounties
list_repos	GitHub repos where the Gitbank bot is installed

Example prompts

• "What is the vault balance for github user octocat?"
• "Show the last 10 transactions for teamgitbank."
• "What is the status of the 'v2-launch' project owned by gitbank?"
• "Is the Gitbank bot installed for user alice?"

Transport

Uses MCP StreamableHTTP transport. Stateless — each request is independent, no persistent connection required.

Architecture

AI Client (Claude / IBM Bob / Cursor / any MCP client)
    |  MCP over HTTP POST
    v
gitbank.io/api/mcp
    +-- get_vault_balance  -> GitHub API + Base mainnet RPC (viem)
    +-- get_transactions   -> PostgreSQL (Drizzle ORM)
    +-- get_project_status -> PostgreSQL (Drizzle ORM)
    +-- list_repos         -> PostgreSQL (installations table)

What is Gitbank?

Gitbank is an AI-powered IssueOps platform for Web3 teams on Base L2. All vault operations run via GitHub bot mentions. The MCP server gives AI assistants read-only visibility into vault state and project budgets.

• Web: https://gitbank.io
• GitHub App: https://github.com/apps/gitbankbot
• Contract: https://basescan.org/address/0xAA0a4ff46733EBaE8E658642A1314f18980fc77B

License

Apache-2.0. See LICENSE.