convez.ai
MCP ServerFinanceiroAvançado
gitbankio

Gitbank MCP Server

gitbankio/MCP

IA com visibilidade real ao tesouro on-chain do seu projeto Web3

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta assistentes de IA a vaults de tesouro cripto no Base L2, fornecendo leitura em tempo real de dados on-chain e execução de operações financeiras com confirmação via GitHub. Integra gerenciamento de orçamento de projetos open-source com automação de pagamentos a contribuidores.

Instalação

$npx convez-ai gitbankio/MCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar saldo e status de orçamento de projetos em tempo real
  • Auditar histórico de pagamentos a contribuidores na blockchain
  • Autorizar movimentações de fundos com segurança GitHub (2FA, YubiKey)
  • Coordenar finanças de times open-source sem sair do assistente de IA

Veredito

Ferramenta niche mas bem arquitetada para um problema real em DAOs e projetos Web3: dar transparência cripto a assistentes de IA. A abordagem de confirmação via GitHub é pragmática. Exige conhecimento de blockchain e Web3 para máxima utilidade.

README

A tradução para o português deste README ainda está na fila.

@gitbank/mcp

IBM AI Builders Challenge submission - Wildcard: Future of Work

MCP server for Gitbank. Gives any MCP-compatible AI assistant read and write access to Gitbank vaults on Base L2.

Read tools return live on-chain data instantly. Write tools queue a command and return a confirm code. The user posts the code on GitHub to authorize execution - GitHub account security (YubiKey, 2FA) protects all vault operations.

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

Live endpoint

No installation needed. Connect directly:

https://gitbank.io/api/mcp

IBM watsonx.ai setup

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

Once connected, ask watsonx.ai:

"Brief me on the Q3 Sprint budget before standup."

It calls get_project_status and responds:

"Q3 Sprint: 500 USDC total, 320 spent (64%), 180 remaining. 8 tasks, 3 paid out. Last payout: 50 USDC to @contributor on PR #89. Confirmed on Base Mainnet."

Every answer is backed by live on-chain data, not a spreadsheet.

Why this is the Future of Work

Open-source Web3 teams coordinate through GitHub Issues and PRs. They pay contributors in crypto. They ask AI assistants questions about project health.

Today those three workflows are completely disconnected:

  • Vault state lives on-chain and nobody checks it
  • Bounty payouts happen in GitHub comments, hard to audit
  • AI assistants have zero visibility into on-chain treasury data

Gitbank connects all three. The GitHub bot executes treasury operations. The smart vault holds team budget on Base. The MCP server gives AI assistants like IBM watsonx real-time read access to everything.

A PM can ask "are we on budget for Q3?" and get a real answer - instantly, from on-chain data.

Quick setup

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

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

Kimi.ai

Install the ready-made plugin in one command inside Kimi:

/plugins install https://github.com/gitbankio/kimi-plugin
/reload

Or add manually to any MCP client config:

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

Cursor / VS Code

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

Tools

Read tools (instant, no confirmation required)

ToolDescription
get_vault_balanceWETH and USDC locked in a user's vault on Base mainnet
get_transactionsRecent on-chain activity: deposits, withdrawals, swaps, bounty payouts
get_project_statusProject budget, spent, remaining, and per-task bounty status
list_reposGitHub repos where the Gitbank bot is installed for a user
check_pendingPoll status of a pending write command by confirm code

Write tools (GitHub confirm required)

These queue a command and return a confirm_code. To execute, the user opens https://github.com/gitbankio/playground/discussions/4 and posts @gitbankbot confirm <code>. The bot verifies GitHub identity via signed webhook and runs the transaction.

ToolDescription
request_depositLock USDC or WETH into the vault
request_withdrawWithdraw tokens to any wallet address
request_swapSwap USDC to WETH or WETH to USDC inside the vault via Uniswap v3
request_assign_bountyAssign a bounty to a contributor for a GitHub issue
request_launch_tokenLaunch a token on Base mainnet via Clanker

How write tools work

1. Ask your AI: "swap 50 USDC to WETH for user alice"

2. AI calls: request_swap(github_username="alice", amount=50, from_token="USDC", to_token="WETH")
   Returns: { confirm_code: "mcp3f9a12b4", expires_in_minutes: 10 }

3. AI replies: "To authorize, open:
               https://github.com/gitbankio/playground/discussions/4
               Post: @gitbankbot confirm mcp3f9a12b4
               (expires in 10 minutes)"

4. You click the link and post the comment (YubiKey login protects this step).
   The bot verifies your GitHub identity via signed webhook and executes the swap.
   Relayer pays all gas - you pay nothing.

5. Tell your AI: "done"
   AI calls: check_pending("mcp3f9a12b4")
   Returns: {
     status: "executed",
     result: "amount_in: 50.00 USDC
              amount_out: 0.022419 WETH
              tx_hash: 0xabc123...
              basescan: https://basescan.org/tx/0xabc123..."
   }

Confirm codes expire after 10 minutes. A stolen confirm code is useless without GitHub account access.

Security model

Gitbank vaults are anchored to GitHub user IDs, not wallet private keys. Write operations require a valid GitHub webhook event signed by GitHub's servers - cryptographically verified via HMAC-SHA256.

Even if someone obtains the confirm code from your AI chat history, they cannot execute the command without posting the comment from your authenticated GitHub account.

GitHub account security (YubiKey, passkey, hardware 2FA) is the only thing that matters. Vault assets remain safe even if the MCP endpoint, AI chat log, or server keys are fully compromised.

Example prompts

Read (instant response):

  • "What is the vault balance for GitHub user teamgitbank?"
  • "Show the last 10 transactions for user alice."
  • "How much budget is left in the 'backend-sprint' project?"
  • "Which repos have the Gitbank bot installed for user bob?"

Write (queues command, returns confirm code):

  • "Deposit 100 USDC into my Gitbank vault. My username is alice."
  • "Withdraw 50 USDC to 0x1234... for user alice."
  • "Swap 10 USDC to WETH for user alice."
  • "Assign a 50 USDC bounty to @bob for issue #42 in alice/my-repo."
  • "Launch a token called DevFund, symbol DEV, for user alice."

Transport

MCP StreamableHTTP, stateless. Each request is independent, no session required. Compatible with protocol version 2025-03-26.

Architecture

IBM watsonx.ai / Claude / Kimi.ai / Cursor / any MCP client
    |  MCP JSON-RPC over HTTPS POST
    v
https://gitbank.io/api/mcp
    |
    +-- get_vault_balance   -> GitHub API (resolve username to ID) + Base RPC via viem
    +-- get_transactions    -> PostgreSQL via Drizzle ORM
    +-- get_project_status  -> PostgreSQL via Drizzle ORM
    +-- list_repos          -> PostgreSQL (GitHub App installations)
    +-- request_*           -> PostgreSQL (mcp_pending_commands, 10-min TTL)
    +-- check_pending       -> PostgreSQL (poll status + tx hash + basescan link)

Confirm flow:
    User posts "@gitbankbot confirm <code>" in GitHub discussion
    -> GitHub sends signed webhook to POST /api/webhook
    -> HMAC-SHA256 signature verified
    -> pending command looked up + GitHub identity verified
    -> relayer builds and signs meta-tx + submits to Base Mainnet
    -> result stored in DB, returned by check_pending

Chain: Base L2 Mainnet (chainId 8453) Identity anchor: GitHub Permanent User ID (immutable integer, survives username renames) Vault contract: EIP-1167 minimal proxy clones via GitVaultFactory Gas model: Relayer pays all gas. Contributors pay zero ETH.

What is Gitbank?

Gitbank is an AI-powered IssueOps platform for Web3 dev teams. Soul-bound vaults on Base mainnet, anchored to GitHub user IDs. All operations run via @gitbankbot mentions in Issues and PRs. Zero gas for users.

License

Apache-2.0. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados