charityverify-mcp
v1.2.0
Published
MCP server + CLI for CharityVerify — trust grades, verdicts, and analysis for 138,000+ Canadian charities
Maintainers
Readme
charityverify-mcp
MCP server + CLI for CharityVerify — trust grades, donor verdicts, and analysis for 138,000+ registered Canadian charities.
CLI
JSON output to stdout — works with any AI tool, script, or pipeline.
npx charityverify signup --email [email protected]
npx charityverify search "food bank" --province ON
npx charityverify lookup 119219814RR0001
npx charityverify verdict 119219814RR0001
npx charityverify check 119219814RR0001
npx charityverify compare 119219814RR0001 131709110RR0001
npx charityverify financials 119219814RR0001
npx charityverify top --limit 5Commands
| Command | Description |
|---------|-------------|
| signup --email <addr> | Provision an API key instantly (self-service). Flags: --agent, --rotate |
| search <query> | Search by name. Flags: --province, --min-grade, --limit |
| lookup <BN> | Full charity profile by business number |
| verdict <BN> | Donor verdict — plain-language assessment |
| check <BN> | Legitimacy check — grade, flags, registered status |
| compare <BN> <BN> [...] | Side-by-side comparison (2-5 charities) |
| financials <BN> | Financial history |
| top | Top-rated charities. Flags: --province, --limit |
MCP Server
For AI assistants that support Model Context Protocol.
npx charityverify-mcpAdd to Claude Code
{
"mcpServers": {
"charityverify": {
"command": "npx",
"args": ["charityverify-mcp"]
}
}
}Add to Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"charityverify": {
"command": "npx",
"args": ["charityverify-mcp"]
}
}
}MCP Tools
| Tool | Description |
|------|-------------|
| provision_access | Self-serve an API key for the session so the assistant can pull data immediately |
| lookup_charity | Look up a charity by CRA business number |
| search_charities | Search charities by name with optional filters |
| get_verdict | Donor verdict for a charity |
| compare_charities | Compare 2-5 charities side by side |
| check_legitimacy | Quick legitimacy check |
Free vs. Paid
Without an API key (default): grade, verdict, basic info, and scores.
With an API key: full Opus-generated analysis, flag details, and 20-dimension score narratives. Get a key instantly with npx charityverify signup --email [email protected], the provision_access MCP tool, or at charityverify.com/pricing.
# CLI
CHARITYVERIFY_API_KEY=cv_your_key npx charityverify lookup 119219814RR0001
# MCP
{
"mcpServers": {
"charityverify": {
"command": "npx",
"args": ["charityverify-mcp"],
"env": { "CHARITYVERIFY_API_KEY": "cv_your_key" }
}
}
}Data
All assessments based on Canada Revenue Agency (CRA) public filings. CharityVerify scores 20+ indicators across legitimacy, effectiveness, and compliance to produce trust grades from A+ to F.
- 138,000+ registered Canadian charities
- 457,000+ directors mapped
- 15 years of financial history
