civicgraph-mcp
v1.1.0
Published
CivicGraph MCP server — Australian government intelligence for AI agents. 560K entities, 1.5M relationships, 770K contracts.
Downloads
225
Maintainers
Readme
civicgraph-mcp
MCP server for CivicGraph — Australian government intelligence for AI agents.
560K entities, 1.5M relationships, 770K contracts, 312K political donations. Cross-referenced by ABN across 11 datasets.
Quick Start
npx civicgraph-mcpWith API key (higher rate limits)
Get a key at civicgraph.app/agent, then:
CIVICGRAPH_API_KEY=cg_live_... npx civicgraph-mcpInstall in Claude Code
claude mcp add civicgraph -- npx civicgraph-mcpWith API key:
claude mcp add civicgraph -- env CIVICGRAPH_API_KEY=cg_live_... npx civicgraph-mcpCLI Options
civicgraph-mcp [options]
Options:
--version, -v Show version number
--help, -h Show help with usage examples and available toolsAvailable Tools
| Tool | Description |
|------|-------------|
| civicgraph_search | Search entities by name or ABN |
| civicgraph_entity | Full entity profile — power score, 7-system presence, board members |
| civicgraph_power_index | Top entities by cross-system power score |
| civicgraph_funding_deserts | Most underserved LGAs by disadvantage vs funding |
| civicgraph_revolving_door | Entities with lobbying + donations + contracts |
| civicgraph_ask | Natural language query across all datasets |
Data Sources
AusTender, AEC donations, ACNC charities, ATO tax transparency, ORIC, justice funding, ALMA evidence, ABR, Lobbying Register, person roles (board members).
Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| CIVICGRAPH_API_KEY | — | API key for authenticated access |
| CIVICGRAPH_URL | https://civicgraph.app | Base URL |
Rate Limits
- Anonymous: 20 requests/minute
- With API key: 60+ requests/minute
Error Handling
v1.1+ provides clear error messages for common issues:
- Network errors — connection refused, DNS resolution failures
- Authentication — invalid or revoked API key with link to get a new one
- Rate limiting — explains current limits and how to upgrade
Changelog
v1.1.0
- Added
--versionand--helpCLI flags - Improved error messages for network, auth, and rate limit failures
- Version now reads from package.json
v1.0.0
- Initial release with 6 tools
License
MIT
