# GiveRadar: full reference for LLMs and agents

> GiveRadar is a free charity intelligence platform: 7.9 million+ nonprofits in 100+ countries, sourced from official government charity registries and tax authorities, with an integrity assessment, financials, leadership and red flags per organization.

This is the complete reference, optimized for LLM and agent consumption. For the short index see https://giveradar.com/llms.txt. For the human-friendly developer page see https://giveradar.com/for-developers/.

Generated from the live API specification, MCP tool schema and data-lineage tables, so it matches what the server does.

## Licence

Data is free for individual use under the GiveRadar Terms (https://giveradar.com/terms/); bulk and commercial access is licensed per contract (info@giveradar.com); methodology documentation and data schemas are CC BY 4.0. Attribution requested: "GiveRadar (giveradar.com)".

## Charity pages

Every organization has a canonical page at `https://giveradar.com/charity/{slug}/`. It carries Organization/NGO JSON-LD (identifiers, address, sameAs, additionalProperty with the integrity assessment, expense ratios, latest fiscal year, total revenue and expenses with ISO currency), a FAQPage node, a BreadcrumbList, a WebPage node with dateModified, and a Review node for the GiveRadar Integrity Assessment. Full filing history, officers and contact details are shown to logged-in users; the public page shows headline figures and ranges.

Every charity page has an "Ask AI" button that opens ChatGPT, Claude, Gemini or Perplexity with the page as the prompt's source. The recommended prompt form: `Using https://giveradar.com/charity/{slug}/ as your source, summarise {name}: registration status, integrity assessment, finances, leadership and any red flags. Cite the page.`

## Integrity assessment

A 0-100 score of public disclosure, not of impact or safety. Components: Registration (0-20), Financial Transparency (0-30, disclosure only), Governance (0-20), Contact Availability (0-10), Data Recency (0-20). Red flag penalty up to -20. Active red-flag types: high_exec_pay, stale_filings (filing gap of five years or more), bare_minimum (minimal disclosure). GiveRadar never penalizes a charity for revenue changes, news coverage, size or data-pipeline lag. Method details: https://giveradar.com/methodology/

Cohort benchmarks: each charity is compared with the tightest local peer set of at least 30 organizations (same country and category, else same country); the compare tab shows exact competition ranks per metric and declines to rank where the cohort is thin or near-uniform.

## REST API

Base URL: https://giveradar.com/api/v1. OpenAPI 3.1 specification: https://giveradar.com/api/openapi.yaml. Documentation: https://giveradar.com/api/docs/. Plans: https://giveradar.com/api/ (Free 10 requests/day, Pro 10,000/day at $99/month, Enterprise 100,000/day).

Access integrity assessments, financial data, officers, and contact information for 7.9 million+ nonprofits across 100+ countries.

## Authentication
All requests require an API key. Get your free key at [giveradar.com/api/keys/](https://giveradar.com/api/keys/).

Pass your key as:
- **Header:** `Authorization: Bearer gr_your_key_here`
- **Query param:** `?api_key=gr_your_key_here`

## Rate Limits
| Tier | Requests/day | Price |
|------|-------------|-------|
| Free | 10 | $0/month |
| Pro | 10,000 | $99/month |
| Enterprise | 100,000 | Custom |

### GET /search/

Search charities

Search charities by name, EIN, or country code. Returns up to 30 results sorted by trust score and revenue.

Parameters:
- `q` (query, string): Search query (charity name or EIN)
- `country` (query, string): 2-letter country code

Response fields:
  - `query` (string)
  - `country` (string)
  - `count` (integer)
  - `results` (array)

### GET /charity/{slug}/

Get charity details

Get full charity profile including financials, officers, red flags, and review summary.

Parameters:
- `slug` (path, string, required): Charity URL slug

Response fields:
  - `id` (string)
  - `slug` (string)
  - `name` (string)
  - `country_code` (string)
  - `description` (string)
  - `category` (string)
  - `founded_year` (integer)
  - `website` (string)
  - `city` (string)
  - `state_province` (string)
  - `ein` (string)
  - `uk_charity_number` (string)
  - `registration_number` (string)
  - `annual_revenue` (integer)
  - `annual_expenses` (integer)
  - `program_expenses` (integer)
  - `admin_expenses` (integer)
  - `fundraising_expenses` (integer)
  - `overhead_ratio` (number)
  - `program_spend_pct` (number)
  - `top_exec_name` (string)
  - `top_exec_title` (string)
  - `top_exec_compensation` (integer)
  - `employee_count` (integer)
  - `email` (string)
  - `phone` (string)
  - `address` (string)
  - `donation_url` (string)
  - `mission_statement` (string)
  - `logo_url` (string)
  - `twitter_url` (string)
  - `facebook_url` (string)
  - `instagram_url` (string)
  - `linkedin_url` (string)
  - `youtube_url` (string)
  - `trust_score` (integer)
  - `data_completeness` (integer)
  - `verified` (boolean)
  - `sanctions_status` (string)
  - `charity_navigator_score` (number)
  - `charity_navigator_rating` (integer)
  - `guidestar_seal` (string)
  - `cause_tags` (array)
  - `operating_countries` (array)
  - `sdg_goals` (array)
  - `data_sources` (array)
  - `last_updated` (string)
  - `recent_filings` (array)
  - `officers` (array)
  - `red_flags` (array)
  - `review_summary` (object)

### GET /charity/{slug}/financials/

Get financial filings

Get up to 10 years of financial filing history plus spending breakdown and executive compensation.

Parameters:
- `slug` (path, string, required): 

Response fields:
  - `filings` (array)
  - `spending_breakdown` (object)
  - `executive_compensation` (object)

### GET /charity/{slug}/news/

Get news and sentiment

Get recent news articles and average sentiment score for a charity.

Parameters:
- `slug` (path, string, required): 

Response fields:
  - `articles` (array)
  - `article_count` (integer)
  - `average_tone` (number)

### POST /charity/{slug}/reviews/

Submit a review

Submit a review for a charity.

Parameters:
- `slug` (path, string, required): 

Request body (application/json):
  - `user_name` (string)
  - `user_role` (string)
  - `rating` (integer)
  - `title` (string)
  - `comment` (string)

### GET /stats/

Platform statistics

Get platform-wide statistics including total charities, countries, and average trust score.

Response fields:
  - `total_charities` (integer): All organizations in the GiveRadar database (including unlisted rows).
  - `listed_charities` (integer): Organizations currently listed on the public site.
  - `total_countries` (integer)
  - `total_red_flags` (integer)
  - `avg_trust_score` (number)

### Python client

`pip install giveradar` (https://github.com/matt-timmermans/giveradar-python, MIT). `from giveradar import Client; Client().search('oxfam', country='GB')`; CLI: `giveradar search`, `verify`, `charity`, `financials`, `news`, `stats`, all with `--json`. Key from GIVERADAR_API_KEY.

## MCP server

Endpoint: https://giveradar.com/mcp/ (JSON-RPC 2.0 over HTTPS; Streamable HTTP clients and mcp-remote both work). Discovery manifests: https://giveradar.com/.well-known/mcp.json and https://giveradar.com/.well-known/ai-plugin.json. Handshake methods (initialize, ping, tools/list) are free and do not count; tools/call and resources/read count against the quota. Anonymous: 10 requests/day per IP. A Pro or Enterprise API key (Authorization: Bearer gr_...) raises the limit and unlocks the full fields. Agents that speak MCP should prefer /mcp/ over scraping HTML: structured, cheaper, always current.

Never exposed through MCP or the free API tier: email addresses, phone numbers, officer full names and compensation.

### Tools

#### search_charities

Search the charity registry by free-text name. Returns up to `limit` matches, each with slug, name, country, city/state, foundation_type, integrity_score, and the canonical page URL. Use this BEFORE resources/read when the user names a charity but you don't know its slug. The match is case-insensitive substring on the charity's name.

Arguments:
- `query` (string, required): Name search query, 2+ chars.
- `country` (string): Optional ISO 3166-1 alpha-2 country filter (e.g. 'ID', 'NL').
- `limit` (integer, default 10, 1..25): 

#### compare_charities

Side-by-side comparison of 2-5 charities by slug. Returns their integrity scores, program/admin/fundraising ratios, annual revenue, founding year, foundation type, and a deterministic verdict on which has the strongest transparency signal. Use this when the user wants to choose between named charities.

Arguments:
- `slugs` (array, required): Charity slugs to compare (2-5).

#### find_similar

Given one charity's slug, return up to `limit` other charities in the same country + category. Useful for 'find more like this' recommendations. Excludes the input charity from the result.

Arguments:
- `slug` (string, required): Source charity slug.
- `limit` (integer, default 8, 1..20): 

#### verify_charity

Look up a charity by its official registry identifier - EIN (US), Charity Commission number (GB), RSIN (NL), AHU/Kemenkumham reg number (ID), or a generic registration_number for other countries. Returns the matched charity or null. Use this when the user provides a registry number and wants to confirm what's registered under it.

Arguments:
- `country` (string, required): ISO 3166-1 alpha-2 country code.
- `id_value` (string, required): The registration / EIN / charity number.

### Connect

Claude Desktop (claude_desktop_config.json):

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

Claude Code: `claude mcp add giveradar --transport http https://giveradar.com/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, then Create with server URL https://giveradar.com/mcp/ and authentication none (paid plans).

## Data sources by country

Official registers GiveRadar imports from, with format and last refresh (year-month). Countries marked directory-sourced have no importable government register; those organizations are "listed on GiveRadar", not registry-verified. Full page: https://giveradar.com/data-sources/

- Argentina (AR): Inspección General de Justicia (IGJ) <https://www.argentina.gob.ar/justicia/igj>; format: Open data portal; refresh: 2026-02; ~172,100 organizations
- Australia (AU): Australian Charities and Not-for-profits Commission (ACNC) <https://www.acnc.gov.au/charity>; format: Bulk CSV download (Charity Register + AIS); refresh: 2026-04; ~64,600 organizations. Full charity register plus Annual Information Statements with financials.
- Austria (AT): Vereinsregister (Federal Ministry of the Interior) <https://www.bmi.gv.at/>; format: Public register; refresh: 2026-02; ~800 organizations
- Bangladesh (BD): NGO Affairs Bureau <https://ngoab.gov.bd/>; format: Public register; refresh: 2026-02; ~2,900 organizations
- Belgium (BE): Banque-Carrefour des Entreprises / Kruispuntbank van Ondernemingen (KBO) <https://kbopub.economie.fgov.be/kbopub/zoeknaamfonetischform.html>; format: Bulk download; refresh: 2026-02; ~145,700 organizations
- Brazil (BR): Receita Federal CNPJ Public Data <https://dados.gov.br/dados/conjuntos-dados/cadastro-nacional-da-pessoa-juridica---cnpj>; format: Bulk download; refresh: 2026-02; ~688,700 organizations. Filtered to nonprofit legal forms (Associations, Foundations).
- Canada (CA): Canada Revenue Agency (CRA) T3010 Charity Returns <https://apps.cra-arc.gc.ca/ebci/hacc/srch/pub/dsplyBscSrch>; format: Bulk CSV download; refresh: 2026-04; ~80,300 organizations
- Chile (CL): Registro Civil + Registro Nacional de Personas Jurídicas <https://www.registrocivil.cl/>; format: Open data portal; refresh: 2026-02; ~21,600 organizations
- Colombia (CO): RUES (Registro Unico Empresarial y Social) + DIAN RTE <https://www.datos.gov.co/>; format: API (Socrata); refresh: 2026-02; ~272,200 organizations
- Croatia (HR): Registar udruga (Ministry of Public Administration) <https://registri.uprava.hr/#!udruge>; format: Public register; refresh: 2026-02; ~44,900 organizations
- Czech Republic (CZ): Justice.cz (Ministry of Justice business register) <https://or.justice.cz/>; format: Public register; refresh: 2026-02; ~8,000 organizations
- Denmark (DK): CVR (Central Business Register) <https://datacvr.virk.dk/>; format: ElasticSearch API; refresh: 2026-03; ~254,000 organizations. Filtered to nonprofit legal forms; foundations from Erhvervsstyrelsen.
- Estonia (EE): Estonian e-Business Register (RIK) <https://ariregister.rik.ee/en>; format: Open data (CSV/JSON); refresh: 2026-02; ~14,816 organizations
- Finland (FI): PRH (Finnish Patent and Registration Office), Poliisihallitus fundraising permits, Vero tax lists, STEA <https://avoindata.prh.fi/en>; format: Open data API + published registers; refresh: 2026-08; ~107,000 organizations
- France (FR): Répertoire National des Associations (RNA), Ministry of the Interior <https://www.data.gouv.fr/fr/datasets/repertoire-national-des-associations/>; format: Bulk CSV download; refresh: 2026-03; ~773,100 organizations. All declared associations; financial detail from JOAFE comptes when filed.
- Germany (DE): Bundeszentralamt für Steuern (BZSt) Zuwendungsempfängerregister <https://www.bzst.de/DE/Unternehmen/Zuwendungsempfaengerregister_organisation/zuwendungsempfaengerregister_organisation_node.html>; format: Public charity register; refresh: 2026-05; ~682,300 organizations. Tax-deductible donation recipients (682K listed after 228K non-charity exclusions); supplemented with OffeneRegister, betterplace, Bundestag Lobbyregister.
- Ghana (GH): Department of Social Welfare NGO Registry <https://www.mogcsp.gov.gh/>; format: Public register; refresh: 2026-02; ~2,400 organizations
- Hungary (HU): civil.info.hu (National Civil Information Portal) <https://civil.info.hu/>; format: Public register; refresh: 2026-02; ~57,300 organizations
- India (IN): FCRA register (Ministry of Home Affairs, FCRA Online) <https://fcraonline.nic.in/>; format: Bulk CSV download; refresh: 2026-02; ~14,600 organizations
- Indonesia (ID): Research-institute NGO database (non-government source, not named by agreement); format: Research database; refresh: 2026-02; ~1,700 organizations
- Ireland (IE): Charities Regulator (Charities Regulatory Authority) <https://www.charitiesregulator.ie/>; format: Public register (XLSX) + Annual Reports CSV; refresh: 2026-06; ~11,481 organizations. Financials (income, expenditure, employee counts) merged from the Charities Regulator Annual Reports dataset.
- Isle of Man (IM): Isle of Man Register of Charities (Charities Registration and Regulation Act 2019) <https://www.gov.im/about-the-government/offices/attorney-generals-chambers/crown-office/charities/>; format: Official register (PDF index); refresh: 2026-06; ~613 organizations. Crown Dependency, not part of the UK. Parsed from the Attorney General's Chambers public Register of Charities.
- Israel (IL): GuideStar Israel + data.gov.il Amutot registry <https://data.gov.il/dataset/amutot>; format: REST API; refresh: 2026-03; ~76,300 organizations
- Italy (IT): RUNTS (Registro Unico Nazionale del Terzo Settore) <https://servizi.lavoro.gov.it/runts/>; format: Public register; refresh: 2026-02; ~140,500 organizations
- Japan (JP): Cabinet Office NPO Portal Site <https://www.npo-homepage.go.jp/>; format: Bulk download; refresh: 2026-03; ~89,100 organizations
- Jersey (JE): Jersey Charity Commissioner (Charities (Jersey) Law 2014) <https://www.charitycommissioner.je/>; format: Public Register of Charities; refresh: 2026-06; ~478 organizations. Crown Dependency, not part of the UK. Sourced from the Jersey Charity Commissioner's public register.
- Kenya (KE): NGO Coordination Board <https://ngobureau.go.ke/>; format: Public register; refresh: 2026-02; ~4,400 organizations
- Latvia (LV): Lursoft Enterprise Register <https://www.lursoft.lv/>; format: Public register; refresh: 2026-02; ~27,600 organizations
- Malaysia (MY): Curated NGO directory (non-government source, not named by agreement); format: Curated directory; refresh: 2026-02; ~1,900 organizations
- Mexico (MX): SAT Donatarias Autorizadas <https://www.gob.mx/sat>; format: Bulk download; refresh: 2026-04; ~10,700 organizations
- Nepal (NP): Social Welfare Council (SWC) <http://www.swc.org.np/>; format: Public registry; refresh: 2026-02; ~58,500 organizations
- Netherlands (NL): Belastingdienst ANBI Register <https://www.belastingdienst.nl/wps/wcm/connect/nl/aftrek-en-kortingen/content/anbi-status-controleren>; format: XML download; refresh: 2026-04; ~54,300 organizations. Tax-recognized public benefit organizations (ANBI status); financial figures from annual financial statements.
- New Zealand (NZ): Charities Services (Department of Internal Affairs) <https://www.charities.govt.nz/>; format: OData API; refresh: 2026-04; ~29,500 organizations
- Nigeria (NG): Corporate Affairs Commission (CAC) <https://www.cac.gov.ng/>; format: Public register; refresh: 2026-02; ~19,500 organizations
- Norway (NO): Brønnøysund Register Centre <https://www.brreg.no/>; format: REST API + accounts; refresh: 2026-04; ~133,200 organizations
- Peru (PE): Agencia Peruana de Cooperación Internacional (APCI) <https://www.apci.gob.pe/>; format: Public register; refresh: 2026-02; ~3,500 organizations
- Philippines (PH): DSWD accreditation and licensing lists <https://www.dswd.gov.ph/>; format: Published lists; refresh: 2026-02; ~1,900 organizations
- Poland (PL): Krajowy Rejestr Sądowy (KRS) <https://ekrs.ms.gov.pl/>; format: REST API; refresh: 2026-02; ~137,200 organizations
- Portugal (PT): Base de Dados Social (BDS) <http://www.seg-social.pt/>; format: REST API; refresh: 2026-04; ~36,600 organizations
- Romania (RO): Registrul National ONG (Ministry of Justice) <https://www.just.ro/registrul-national-ong/>; format: Bulk download; refresh: 2026-06; ~112,413 organizations
- Russia (RU): Ministry of Justice SONKO Registry <https://unro.minjust.ru/>; format: Public registry; refresh: 2026-04; ~47,000 organizations
- Serbia (RS): Agencija za privredne registre (APR) <https://www.apr.gov.rs/>; format: Public register; refresh: 2026-02; ~40,400 organizations
- South Africa (ZA): Department of Social Development NPO Directorate <http://www.npo.gov.za/>; format: REST API; refresh: 2026-04; ~265,000 organizations
- South Korea (KR): Ministry of Interior public-interest corp registry + NTS 공익법인 disclosures <https://www.mois.go.kr/>; format: Public registries; refresh: 2026-04; ~11,200 organizations
- Spain (ES): Registro Nacional de Asociaciones (Ministerio del Interior) <https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/asociaciones/>; format: Bulk download; refresh: 2026-02; ~190,000 organizations
- Sweden (SE): Skatteverket (Swedish Tax Agency) <https://www.skatteverket.se/>; format: Excel download; refresh: 2026-03; ~138,500 organizations
- Switzerland (CH): Zentralregister der schweizerischen Stiftungen (ZEWO + foundation registry) <https://www.edi.admin.ch/edi/en/home/topics/foundation-supervision.html>; format: Public register; refresh: 2026-02; ~30,200 organizations
- Tanzania (TZ): Ministry of Community Development NGO Registry <https://www.jamii.go.tz/>; format: Public register; refresh: 2026-02; ~9,000 organizations
- Thailand (TH): Revenue Department e-Donation lists of approved charitable organizations <https://www.rd.go.th/>; format: Published lists; refresh: 2026-02; ~46,200 organizations
- Ukraine (UA): USREOU (Unified State Register of Legal Entities) <https://usr.minjust.gov.ua/>; format: Open data portal; refresh: 2026-02; ~192,200 organizations
- United Kingdom (GB): Charity Commission for England & Wales (CCEW), OSCR (Scotland), CCNI (Northern Ireland) <https://register-of-charities.charitycommission.gov.uk/>; format: Bulk JSON + CSV downloads; refresh: 2026-06; ~203,617 organizations. England & Wales from CCEW (incl. annual returns + trustee records); Scotland from the OSCR 5-year register export; Northern Ireland from the CCNI register. Welsh charities are postcode-tagged so all four nations can be filtered separately.
- United States (US): IRS Exempt Organizations Master File + Form 990 filings <https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf>; format: Bulk CSV + XML download; refresh: 2026-04; ~1,581,000 organizations. 501(c)(3) public charities and private foundations; fiscal-year financials from electronically filed 990s.

### Third-party and enrichment sources

- DZI Spenden-Siegel <https://www.dzi.de/>: 
- GDELT Project <https://www.gdeltproject.org/>: 
- Wikidata <https://www.wikidata.org/>: 
- IATI Datastore <https://iatistandard.org/>: 

## Discovery and policies

- Sitemap: https://giveradar.com/sitemap.xml (index tier; every charity remains reachable via search, the API and MCP)
- OpenAPI: https://giveradar.com/api/openapi.yaml
- MCP manifest: https://giveradar.com/.well-known/mcp.json
- Short index: https://giveradar.com/llms.txt
- Content signals (robots.txt): search=yes, ai-input=yes, ai-train=yes
- Contact: info@giveradar.com