@gitgrant/mcp

GitGrant CLI and MCP server — interact with onchain bounties from your terminal or AI agent.

Installation

npm install -g @gitgrant/mcp

CLI Usage

gitgrant                          # Show help
gitgrant list                     # List all bounties
gitgrant list --status Open       # Filter by status
gitgrant list --repo owner/repo   # Filter by repo
gitgrant active                   # List Open + Claimed bounties
gitgrant get github:owner/repo#123
gitgrant stats                    # Platform statistics
gitgrant id github:owner/repo#123 # Compute bounty ID
gitgrant chain                    # Show chain info

Options

--status   Filter by status (comma-separated): Open,Claimed,Submitted,Completed
--repo     Filter by repo (owner/repo)
--limit    Max results (default 20)
--offset   Pagination offset

MCP Server

Use GitGrant as an MCP tool server for AI agents (Claude, Cursor, etc.).

gitgrant-mcp

Available MCP Tools

| Tool | Description | |------|-------------| | list_bounties | List bounties with filters | | get_bounty | Get bounty detail by ID or issue URI | | get_stats | Platform statistics | | compute_bounty_id | Compute bounty ID from issue URI | | parse_issue_uri | Parse issue URI into components |

Claude Desktop Config

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "gitgrant": {
      "command": "gitgrant-mcp",
      "env": {
        "GITGRANT_API_URL": "https://api.gitgrant.app"
      }
    }
  }
}

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | GITGRANT_API_URL | https://api.gitgrant.app | GitGrant API base URL | | RPC_URL | https://mainnet.base.org | Base RPC endpoint | | ESCROW_ADDRESS | mainnet contract | BountyEscrow contract address | | CHAIN_ID | 8453 | Chain ID (8453 = Base mainnet) |

License

MIT