charity-registry

GiveRadar MCP 服务

远程 MCP 服务，提供来自官方政府慈善机构注册机构和税务机关（IRS、Charity Commission、ACNC 等数十个机构）的 100 多个国家/地区 790 多万家非营利组织数据。只读，无需密钥即可开始使用。

端点： https://giveradar.com/mcp/（基于 HTTPS 的 JSON-RPC 2.0） 文档： giveradar.com/mcp | 清单： /.well-known/mcp.json

工具

工具	功能
search_charities	按名称进行自由文本搜索（基于三元组索引），可选按国家/地区筛选
verify_charity	按 EIN / 英国慈善机构编号 / RSIN / 任何官方注册编号查询
compare_charities	并排比较诚信评分和财务信息，并给出结论
find_similar	查找同一国家/地区和类别下的其他慈善机构

此外，还可通过 resources/list / resources/read 获取每家慈善机构的完整 schema.org JSON-LD 数据（包括常见问题）。所有工具均为只读（readOnlyHint: true）。

连接

原生支持可流式 HTTP 的客户端可直接连接到 https://giveradar.com/mcp/。每种客户端的配置说明及截图见：giveradar.com/for-developers/#ai。

Claude Code（一行配置）：

claude mcp add giveradar --transport http https://giveradar.com/mcp/

Claude Desktop（claude_desktop_config.json），通过通用远程桥接：

{
  "mcpServers": {
    "giveradar": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://giveradar.com/mcp/"]
    }
  }
}

或通过此仓库中零依赖的 stdio 桥接（index.js）：

{
  "mcpServers": {
    "giveradar": {
      "command": "npx",
      "args": ["-y", "github:matt-timmermans/giveradar-mcp"]
    }
  }
}

Cursor（.cursor/mcp.json）：{"mcpServers": {"giveradar": {"url": "https://giveradar.com/mcp/"}}}

Gemini CLI（~/.gemini/settings.json）：{"mcpServers": {"giveradar": {"httpUrl": "https://giveradar.com/mcp/"}}}

ChatGPT：依次进入 Settings、Connectors、Advanced，启用 Developer mode，然后选择 Create，服务器 URL 填写 https://giveradar.com/mcp/，身份验证选择 none（付费套餐）。

可选：在环境中设置 GIVERADAR_API_KEY=gr_xxxxx，即可提高每日配额并解锁 Pro 字段。

试用

curl -s -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"verify_charity","arguments":{"country":"US","id_value":"13-1760110"}}}' \
  https://giveradar.com/mcp/

配额与套餐

套餐	每日配额	字段
匿名	每个 IP 每天 10 次	所有免费字段
免费 API 密钥	每天 10 次	所有免费字段
Pro	每天 10,000 次	+ 财务信息、捐赠/报告 URL
Enterprise	每天 100,000 次	+ 财务信息、捐赠/报告 URL

握手方法（initialize、ping、tools/list）免费且不计入配额；tools/call 和 resources/read 会计入配额。每个 IP 的 tools/call 还限制为每分钟 60 次。使用 Authorization: Bearer gr_xxxxx 进行身份验证；可在 giveradar.com/api 获取密钥。任何套餐都不会公开电子邮箱、电话号码和管理人员姓名。

另有提供

• Python 客户端和 CLI： pip install giveradar（giveradar-python）；其中的 verify() 会调用此服务的 verify_charity 工具。
• REST API： giveradar.com/api/docs，OpenAPI 规范见 /api/openapi.yaml。
• 面向大模型： /llms.txt（索引）和 /llms-full.txt（完整参考：端点、工具、诚信评估方法、各国家/地区的数据来源）。

关于

MCP 服务托管于线上（其实现位于 GiveRadar 主代码库）；此仓库包含公开元数据，以及用于本地和沙盒环境的 stdio 桥接。此代码采用 MIT 许可证。数据：个人使用免费，遵循 GiveRadar 条款；批量和商业使用需按合同授权（[email protected]）；方法说明文档和数据架构采用 CC BY 4.0 许可。建议注明来源：“GiveRadar (giveradar.com)”。欢迎在此提交问题和功能请求。