# gitbranch-mcp

Use GitBranch from [Claude](https://claude.ai), [Cursor](https://cursor.sh), [ChatGPT](https://chatgpt.com), or any MCP compatible AI client.

## Quick Start with Claude Desktop or Cursor

Add this to your `claude_desktop_config.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gitbranch": {
      "command": "npx",
      "args": ["gitbranch-mcp"],
      "env": {
        "GITBRANCH_API_URL": "https://api.gitbranch.org",
        "GITBRANCH_GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}
```

## Streamable HTTP Mode

```bash
npx gitbranch-mcp --http --port 3001
```

Connect via `http://localhost:3001/mcp`.

## Tools

| Tool | Description |
|------|-------------|
| `get_vault` | Get vault address and balances |
| `buy_stock` | Buy a stock token: NVDA, TSLA, AAPL and more |
| `sell_stock` | Sell a stock token back to USDG |
| `get_portfolio` | Full portfolio snapshot |
| `get_pending` | List pending transactions |
| `swap_stock` | Swap between two stock tokens |

## Development

```bash
pnpm install
pnpm build
pnpm start
```

## License

[Apache 2.0](LICENSE)