Tool reference

All 40 tools the DonorAtlas MCP server exposes to AI assistants. Every tool is available to anyone whose account has MCP access. This page is generated from the live server, so it always matches deployed behavior.

Server endpoint: https://mcp.donoratlas.com

Looking for what to do with them? See the MCP Library.

Account & Access

get_access_info

Explain whether the user has DonorAtlas MCP access and, if not, how to get it. Call it when the user asks why tools are missing or how to get set up.

Example responses (2)
no access
Your team has MCP seats, but none is assigned to you. Ask a DonorAtlas team admin to assign you one under Team Members on the My Profile page, or contact team@donoratlas.com. Once you have a seat, reconnect this connector.
full access
## Your DonorAtlas access
You have DonorAtlas MCP access, so every tool is available: donor research (lookup, profiles, giving, contact info, search, lists, networks, share links); team info; live research and imports; exports.

get_my_account

Get the user's DonorAtlas account, team and role. Use it to confirm which account and team the other tools act on.

Example response (1)
response
## Jordan Ellis
- Email: jordan@example.org
- Team: Acme Philanthropy Advisors
- Plan: Enterprise
- Role on team: Admin

whoami

Show who this connector is signed in as and whether it has DonorAtlas MCP access.

Example response (1)
response
## MCP identity
- Subject: `auth0|000000000000000000000000`
- Client: `https://claude.ai/oauth/mcp-oauth-client-metadata`
- MCP access: yes
- Token expires: 2026-08-15 03:45 UTC (epoch 1786669516)

For CIMD clients (Claude), the client is the client's metadata URL.

Donor Research

check_lookup

Check on a live research job started by lookup_person or research_person. Pass the job_id the tool returned — and for a research_person job, the person_id it returned too. While a job runs you get its progress. When it finishes you get the profile. That can be a different profile from the one research started on (a better or merged match): use the returned profile's ID from then on. Poll every ~30 seconds, or about once a minute for wealth research.

ParameterTypeRequiredDefault
job_idstringyes
person_idstringno
Example responses (6)
in progress
Status: still researching (62% done, Analyzing wealth signals). Check again in ~30 seconds with `check_lookup(job_id="job_a81f42c7")`.
found
Status: research complete.

## [Jane Doe](https://app.donoratlas.com/donor/da_5w8y2e6r)
Portland, OR · age 54
…full basic profile…
no match
Status: research finished without a confident match. The person may have little public presence; try lookup_person again with any additional details you have.
research in progress
Status: still researching (40% done, Researching wealth). Check again in about a minute with `check_lookup(job_id="job_c27e90d4", person_id="da_7f3k2m9x")`.

A research_person job, polled with the person_id its reply carried.

research complete
Status: research complete.

## [Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)
Chicago, IL · age 67 · spouse: Margaret Smith
…summary profile…

## Wealth — Robert Smith
**Net worth:** $9B–$14B (est. $11B)
…wealth details…

Profile research returns the summary profile, wealth research the wealth details, and research of both returns both. The profile is the one the research resolved to, which can be a better or merged profile than the person_id passed; the person_id is used when the job doesn't name one. Delivering it counts as one profile view.

not a research job
`job_5d1e8b20` isn't a live research job's ID: this tool can only track jobs lookup_person and research_person started. If you are doing an import, use get_list and list_lists to track progress.

import_people hands out no job to check; its reply links the list it fills.

get_board_memberships

Nonprofit board service for a person.

ParameterTypeRequiredDefault
person_idstringyes
pageintegerno1
Example response (1)
response
## Board service — 5 organizations
- Art Institute of Chicago — Trustee (2015–2025)
- Field Museum — Director (2012–2023)
- Northwestern University — Trustee (2018–2024)

Rows are grouped by organization — ten years on one board is one line, not ten.

get_contact_info

Get a person's contact information (emails and phone numbers). Request only the channels the user's task needs, and ask once with all of them.

ParameterTypeRequiredDefault
person_idstringyes
reveal_job_idstringno
include_work_emailbooleannotrue
include_personal_emailbooleannotrue
include_mobile_phonebooleannofalse
Example responses (3)
response (default flags: emails only)
## Contact information
- Personal email: r.smith@vistapoint.com (verified)
- Work email: rsmith@corp.com (unverified — catch-all domain)

Emails are included by default; phones only with include_mobile_phone=true. Every call counts as one contact reveal against the user's limit, whatever it finds and even for a person already revealed, so ask once with every channel the task needs.

only a phone on file, emails requested
No contact info in the requested channels. The reveal found this in other channels instead:

## Contact information
- Mobile phone: (312) 555-0148 (verified)
nothing found
No contact information could be found for this person. This is the answer, so don't ask again; the reveal still counts as one against the user's contact-reveal limit.

get_giving_history

Itemized charitable (nonprofit) giving for a person.

ParameterTypeRequiredDefault
person_idstringyes
pageintegerno1
Example response (1)
response
## Charitable giving — Robert Smith
**Art Institute of Chicago** — $5M–$8M across 9 gifts
  - 2025 — $1M–$2.5M
  - 2023 — $500K–$1M
  - 2021 — $2.5M
**Northwestern University** — $4M–$6M across 7 gifts
  - 2024 — $500K–$1M
  - 2022 — amount undisclosed
…
*Page 1 of 2 (19 organizations total).*

Grouped per organization: the deduplicated total first, then each gift's year and amount.

get_person_profile

Get a person's profile by their DonorAtlas person ID. By default, this gives back a summary — demographics, bio, wealth, giving snapshot, etc. Set full=true for the whole profile (including connections, full bio, complete work and education history, etc). When telling the user about a person, share the DonorAtlas profile link from the markdown, never a raw ID.

ParameterTypeRequiredDefault
person_idstringyes
fullbooleannofalse
Example response (1)
response
## [Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)
Chicago, IL · age 67 · spouse: Margaret Smith

Founder and chairman of Vista Point Capital…

**Wealth:** net worth $9B–$14B (est. $11B); liquidity $1B–$2B
**Giving:** predicted annual giving $4.2M; 48 public gifts across 19 organizations totalling $22M–$31M; largest gift $2.5M; average gift $550K
**Political:** 112 donations, avg $8.4K
**Family foundations:** Smith Family Foundation `npo_smithfdn`
**Top issues:** Arts, Higher Education, Healthcare
**Current boards:** Art Institute of Chicago `npo_art`, Field Museum `npo_field`
**Current role:** Chairman at Vista Point Capital `com_vista`
**Education:** Harvard Business School `sch_hbs`, MBA, 1985

---
*2 team notes · on 3 donor lists · 4 strong connections to your network — set full=true to see them.*
*More detail: get_person_profile — this summary; full=true for the whole profile; get_giving_history — all 73 charitable gifts, itemized; get_political_giving — itemized state and local political donations; get_board_memberships — all 22 board records; get_wealth_details — 12 researched assets, income, real estate; get_contact_info — emails and phones.*
*Last updated 2026-08-02.*

The one-screen summary: every itemized section appears as a count + pointer to its drill-down tool, organizations carry their IDs for get_entity_profile, and full=true adds every section with numbered citations.

get_political_giving

Itemized state and local political donations for a person.

ParameterTypeRequiredDefault
person_idstringyes
pageintegerno1
Example response (1)
response
## Political giving — 112 donations, $940K total
- 2026-03-14 — $50K → Growth PAC (REP), IL
- 2025-11-02 — $6.6K → Friends of J. Alvarez (DEM), IL
…
*Page 1 of 3 (112 rows in all).*

get_wealth_details

A person's full wealth details — net worth, liquidity, income, assets, real estate, etc.

ParameterTypeRequiredDefault
person_idstringyes
Example response (1)
response
## Wealth — Robert Smith
**Net worth:** $9B–$14B (est. $11B)
**Key takeaway:** Primary driver is his ~35% stake in Vista Point Capital…
**Liquidity:** $1B–$2B
Fund distributions and carry are largely cash…
**Published estimates:** forbes.com $10B–$12B [6]

### Income (4)
- **Fund Carry** — Vista Point Capital — $80M–$120M a year (2014–present) [3]
  Carry on Funds V–VII…

### Non-cash assets (12)
- **Private Equity** — Vista Point Capital — $7B–$10B [2]
  Retains control after the 2019 recapitalization…
- **Public Equity** — MDW Holdings — $400M–$600M [5]

### Real estate (4 properties)
- 1200 N Lake Shore Dr, Chicago, IL 60610 — owned; value $4.2M, equity $3.1M, mortgage remaining $1.1M (taken out 2004)
- 55 W Elm St, Chicago, IL 60610 — sold 2004-03-15 for $1.2M

## Sources
[1] LinkedIn — LinkedIn Profile — https://www.linkedin.com/in/…
[2] Chicago Business News — News — https://…

lookup_person

Find a specific person in DonorAtlas and get their profile — use this instead of search_people when the user wants one particular person. Provide every identifying detail you know to increase match confidence. Locations, employers, occupations, schools, and nonprofit affiliations all accept multiple values; locations can be strings ('Chicago, IL', '330 7th Ave, New York') or structured {street_address, city, state, zip_code}. Returns the profile directly on a confident match; a shortlist of candidates when several people fit (pick one, or retry with more detail); or starts live research (a 1–2 minute background job) when nobody matches. Set force_enrich=true *only* when a returned shortlist contained none of the right people: it skips matching and researches the person fresh, and with full identifying details the research lands on the right person. Don't use this tool to research someone who already has a profile — use the research_person tool instead.

ParameterTypeRequiredDefault
first_namestringyes
last_namestringyes
middle_namestringno
locationsarrayno
employersarrayno
occupationsarrayno
schoolsarrayno
affiliated_nonprofitsarrayno
spouse_firststringno
spouse_laststringno
nicknamesarrayno
linkedinstringno
force_enrichbooleannofalse
Example responses (4)
found
## [Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)
Chicago, IL · age 67 · spouse: Margaret Smith

Founder and chairman of Vista Point Capital…

**Wealth:** net worth $9B–$14B (est. $11B); liquidity $1B–$2B
**Giving:** predicted annual giving $4.2M; 48 public gifts across 19 organizations totalling $22M–$31M; largest gift $2.5M; average gift $550K
**Political:** 112 donations, avg $8.4K
**Family foundations:** Smith Family Foundation
**Top issues:** arts_culture, higher_education, health
**Current boards:** Art Institute of Chicago, Field Museum
**Current role:** Chairman at Vista Point Capital
**Education:** Harvard Business School, MBA, 1985

---
*More detail: get_person_profile — this summary; get_giving_history — all 73 charitable gifts, itemized; get_political_giving — all 112 political donations; get_board_memberships — all 22 board records; get_wealth_details — 12 researched assets, income, real estate; get_contact_info — emails and phones.*
*Profile last updated: 2026-08-02*

Exactly one person matched the details — the basic profile comes back immediately.

candidates
Found 3 possible matches:
- **[Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)** — Chicago, IL — age 67 — spouse: Margaret Smith — Chairman at Vista Point Capital
- **[Robert A. Smith](https://app.donoratlas.com/donor/da_2b8n4q1z)** — Evanston, IL — age 81 — Retired orthodontist
- **[Rob Smith](https://app.donoratlas.com/donor/da_9c5r7t3v)** — Chicago, IL — age 44 — spouse: Dana Smith — Partner at Baker & Daniels LLP

Open the right person with get_person_profile (their ID is at the end of their profile link). If none of them is the person, call lookup_person again with more identifying details, or with force_enrich=true to research them fresh.

Slim rows on purpose — enough to tell people apart (name, location, age, spouse, current role); each carries the profile-link ID to pass to get_person_profile.

enriching
DonorAtlas is researching Jane Doe live. This typically takes 1–2 minutes. Tell the user research is underway, then check with `check_lookup(job_id="job_a81f42c7")` (wait ~30 seconds between checks).

*Usage note — tell the user: DonorAtlas MCP live research jobs: 50 of 100 used today (50%), 50 left; resets at midnight UTC.*

Nobody matched (or force_enrich=true) — live research starts in the background, limited per user per day and per month. This run happened to be the day's 50th, so it carries the note that asks the agent to tell the user.

limit reached
No matching person was found in DonorAtlas, and live research can't start. The user has reached DonorAtlas's MCP limit of 100 live research jobs per day. It resets at midnight UTC. Profiles already in DonorAtlas can still be read, and lookup_person still finds people who have one. Other tools still work. For bulk use, contact team@donoratlas.com. Tell the user.

Live Research

research_person

Research a person who already has a DonorAtlas profile. `kind` says what to research: `profile` builds or refreshes their profile (use it when a profile is unenhanced or may be out of date); `wealth` researches their wealth in depth on a profile that has been researched; `profile_and_wealth` does both in one job. A profile takes 1–2 minutes, wealth research 2–5 minutes. Tell the user it's underway, then poll check_lookup with both the job_id and the person_id from the reply. To find someone who isn't in DonorAtlas yet, use lookup_person instead.

ParameterTypeRequiredDefault
person_idstringyes
kindstringyes
Example responses (3)
started
DonorAtlas is researching their profile and wealth live. This typically takes 2–5 minutes. Tell the user research is underway, then check with `check_lookup(job_id="job_c27e90d4", person_id="da_7f3k2m9x")` (wait about a minute between checks).

One research job, one unit of the user's research limits, whatever the kind.

already underway
Research on this person is already underway, so nothing new was started or charged. Tell the user, then check with `check_lookup(job_id="job_b41f03aa", person_id="da_7f3k2m9x")` (wait ~30 seconds between checks).
never researched
Nothing was started or charged: this person's profile hasn't been researched yet, and wealth research needs one. Call research_person with kind=profile_and_wealth instead.

kind=wealth on a profile that was never researched.

Organizations

get_entity_profile

Get an organization's DonorAtlas profile — a nonprofit, company or school — by its ID (`npo_…`, `com_…`, `sch_…`), exactly as a profile, search result or other organization's profile printed it.

ParameterTypeRequiredDefault
entity_idstringyes
Example responses (2)
nonprofit
## [Lakeside Arts Alliance](https://app.donoratlas.com/nonprofit/npo_lakeside)
`entity_id: npo_lakeside`
Nonprofit · Chicago, IL · https://www.lakesidearts.org · EIN 36-2167048 · founded 1961 · NTEE A20
**Key issues:** Arts, Arts Education
**Mission:** Bringing the arts to every Chicago neighborhood.
**Latest revenue:** $4.2M

### About
Lakeside Arts Alliance runs galleries and youth programs across Chicago. [1][2]

### Board members (14)
**Most recently reported board**
- [Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x) `da_7f3k2m9x` — Chair, 2020–2024, Chicago, IL [2]
- [Ann Ito](https://app.donoratlas.com/donor/da_2p9q4r1s) `da_2p9q4r1s` — Trustee, 2021–2024, Evanston, IL (IRS filing, 2023)
…

### People
Groups this large aren't listed. Each comes as a `search_people` schema: run it unchanged, or add filters to its `target_person_description` to narrow it (location, net worth, interests, etc.).
**Donors** (1,840)
```json
{"target_person_description": {"type": "donor", "nonprofit_donation": {"recipient": {"type": "nonprofit", "entity_id": "npo_lakeside", "name": {"type": "name", "value": "Lakeside Arts Alliance", "is_quoted": false}}, "type": "nonprofit_donation"}}, "schema_version": 3}
```
**Volunteers** (about 230)
```json
…
```

### Other affiliations (12)
By affiliation: Committee members (12)
No search covers these, so they're listed here:
- [Lee Park](https://app.donoratlas.com/donor/da_5w8y2e6r) `da_5w8y2e6r` — “Benefit Committee”, Chicago, IL
…

### IRS filings (11)
| Tax year | Form | Revenue | Contributions & grants | … | Net assets |
| [2023](https://app.donoratlas.com/nonprofit/npo_lakeside?filingYear=2023&filingForm=990) | 990 | $4.2M | $3.1M | … | $8.8M |
…

### Grants made ($1.4M to 38 recipients)
By year: 2023: $620K · 2022: $540K · …
By recipient type, each a recipient_type value export_grants and get_grant_recipients take: `Arts Education` $780K · `Youth Development` $310K · …
Largest recipients:
- [Evanston Youth Theater](https://app.donoratlas.com/nonprofit/npo_youth) `npo_youth` — $160K, 3 grants, 2021-2023, Evanston, IL, `Arts Education`
…
23 more recipients: get_grant_recipients pages every recipient, and can narrow them to one recipient_type or sort them.

### Similar organizations
- [Chicago Arts Fund](https://app.donoratlas.com/nonprofit/npo_fund) `npo_fund` — Chicago, IL; shared issues: Arts
…

### Sources and links
Website: https://www.lakesidearts.org
**General**
- [1] https://www.lakesidearts.org/
**Board members**
- [2] https://lakesidearts.org/about (18 records)

Abridged (…). The board is listed by name; larger groups come as search_people schemas pinned to the organization by entity_id, with the count the page shows. Grant recipients and similar organizations carry IDs for another get_entity_profile call.

school
## [Harvard Business School](https://app.donoratlas.com/school/sch_hbs)
`entity_id: sch_hbs`
School · Boston, MA
**Students:** 2,000 · **Founded:** 1908
**Part of:** [Harvard University](https://app.donoratlas.com/school/Q13371) `Q13371`

### About
The graduate business school of Harvard University. [1]

### Sources and links
- https://www.hbs.edu
- [1] https://en.wikipedia.org/wiki/Harvard_Business_School

### Alumni (48,210)
Groups this large aren't listed. …
```json
{"target_person_description": {"type": "donor", "attended_school": {"entity_id": "sch_hbs", "name": {"type": "name", "value": "Harvard Business School", "is_quoted": false}, "type": "school"}}, "schema_version": 3}
```

Companies read the same way: summary, links, and employees as a pinned search.

get_grant_recipients

Every recipient a nonprofit granted to, a page at a time, each with what it was granted in all, over which years, its recipient type, and what the grants were for. Use it when get_entity_profile's Grants made section lists only the largest recipients and you need the rest. Pass the nonprofit's entity_id (`npo_…`) as a profile or search printed it. recipient_type narrows the recipients to one type, written exactly as get_entity_profile's grants section prints it. sort orders every recipient before the page is cut: `organization` (name), `year` (latest granted), `amount` (total granted) or `category` (recipient type), with direction `desc` (the default) or `asc`; without it, the most recently granted come first, then the largest. For a file of every grant, one row each, use export_grants instead.

ParameterTypeRequiredDefault
entity_idstringyes
pageintegerno1
recipient_typestringno
sortstringno
directionstringno"desc"
Example responses (2)
one type, largest first
## Grant recipients of [Lakeside Arts Alliance](https://app.donoratlas.com/nonprofit/npo_lakeside) `npo_lakeside`
Only recipients of type `Arts Education`. Sorted by total granted, largest first.
- [Evanston Youth Theater](https://app.donoratlas.com/nonprofit/npo_youth) `npo_youth` — $160K, 3 grants, 2021-2023, Evanston, IL, `Arts Education`
- [Chicago Children's Choir](https://app.donoratlas.com/nonprofit/npo_choir) `npo_choir` — $95K, 2 grants, 2022-2023, Chicago, IL, `Arts Education`
…

*Page 1 of 2 (31 recipients in all).*

recipient_type="Arts Education", sort="amount". The type is written exactly as get_entity_profile's grants section prints it.

an unmatched recipient
- Friends Of The Park — $20K, 1 grant, 2023, Skokie, IL

A recipient never matched to a nonprofit is named as its filing gives it, with no ID to open.

Team

get_team_info

Get the user's DonorAtlas team: plan, remaining export and import credits, and members.

Example response (1)
response
## Acme Philanthropy Advisors (`team_8f2c41`)
Plan: Enterprise · Exports remaining: 4,120/5,000 · Imports remaining: 880/1,000

**Members:**
- Admin: Jordan Ellis
- User: Dana Cho, Luis Ortega

Lists

add_to_list

Add people to a donor list: pass person_ids, or search_schema (a schema exactly as you'd pass it to search_people) to add everyone that search matches — one, not both. Max 50K results will be added from a search_schema.

ParameterTypeRequiredDefault
list_idstringyes
person_idsarrayno
search_schemaobjectno
Example responses (2)
response
Added 5 people to [Galas › 2024 Gala Attendees](https://app.donoratlas.com/donor_lists/lst_2024gala/1).
from a search (search_schema)
Adding to [Major Prospects Q3](https://app.donoratlas.com/donor_lists/lst_majorpros/1). It's filling in the background with the 214 people the search matches, which can take a minute or two. `list_id: lst_majorpros` · job `job_5d2e8b14`. Don't repeat this call; get_list shows the donor list as it fills.

[Open the donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/lst_majorpros/1) — include this link in your reply.

Counts as one search however many people it adds.

create_list

Create a donor list, optionally filled with people: pass person_ids, or search_schema (a schema exactly as you'd pass it to search_people, max 50K results) to save everyone that search matches. Folders live in a list's name, separated by `//`: `Galas//2026//Spring Gala` is the list "Spring Gala" in the folder "Galas › 2026". Show paths to the user with ›, not the raw `//`. To make an empty folder, create a list named `Folder//.` (a placeholder that holds nobody) with no people.

ParameterTypeRequiredDefault
namestringyes
person_idsarrayno
search_schemaobjectno
Example responses (3)
response
Created donor list **[Gala Trend Prospects](https://app.donoratlas.com/donor_lists/lst_9k2m4x7q/1)** `list_id: lst_9k2m4x7q` with 5 people.

[Open the donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/lst_9k2m4x7q/1) — include this link in your reply.

Fails with a clear error if the name is already taken.

from a search (search_schema)
Created donor list **[Galas › Chicago Philanthropists](https://app.donoratlas.com/donor_lists/lst_4m8q2w6e/1)**. It's filling in the background with the 1,284 people the search matches, which can take a minute or two. `list_id: lst_4m8q2w6e` · job `job_a71c09f3`. Don't repeat this call; get_list shows the donor list as it fills.

[Open the donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/lst_4m8q2w6e/1) — include this link in your reply.

search_schema takes the same schema as search_people and saves every match (up to 50,000). The whole call counts as one search.

empty folder (name `Galas//2027//.`)
Created the empty folder **Galas › 2027** (its placeholder is `list_id: lst_f0ld3r27`). To put donor lists in it, create or rename them with its path.

delete_list

Delete a donor list permanently. Confirm with the user first. Deleting an empty folder's placeholder removes the folder.

ParameterTypeRequiredDefault
list_idstringyes
Example response (1)
response
Deleted donor list `lst_9k2m4x7q`.

get_list

Get a donor list's members, a page at a time, including the two built-in lists list_lists shows (everyone saved, everyone viewed). page_size: up to 25 = full rows; 26-100 = name, link and ID only.

ParameterTypeRequiredDefault
list_idstringyes
pageintegerno1
page_sizeintegerno20
Example response (1)
response
## [Donor list: Galas › 2024 Gala Attendees](https://app.donoratlas.com/donor_lists/lst_2024gala/1)
`list_id: lst_2024gala`
**312 people match** (page 1, 20 shown):
- **[Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)** — Chicago, IL — …
…

[Open this donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/lst_2024gala/1) — include this link in your reply.

Members come back 20 at a time by default; page_size goes up to 100, with rows trimmed to name, link and ID above 25. Each page counts as one search.

list_lists

List the team's donor lists as a folder tree. Folders live in a list's name, separated by `//`: `Galas//2026//Spring Gala` is the list "Spring Gala" in the folder "Galas › 2026". Show paths to the user with ›, not the raw `//`. An empty folder is kept by a placeholder list, shown with its id; rename or delete the placeholder to move or remove the folder.

Example response (1)
response
## Donor lists (5)
- **[All Saved Donors](https://app.donoratlas.com/donor_lists/all-saved-donors/1)** `list_id: all-saved-donors` — 412 people — created 2024-01-09 by DonorAtlas — read-only
- **[Major Prospects Q3](https://app.donoratlas.com/donor_lists/lst_majorpros/1)** `list_id: lst_majorpros` — 58 people — created 2025-07-01 by Jordan Ellis

**Galas**
- **[2024 Gala Attendees](https://app.donoratlas.com/donor_lists/lst_2024gala/1)** `list_id: lst_2024gala` — 312 people — created 2024-03-14 by Dana Cho
- **[2026 Spring Gala](https://app.donoratlas.com/donor_lists/lst_spring26/1)** `list_id: lst_spring26` — still filling in the background (1,180 people so far) — created 2026-10-13 by Jordan Ellis

**Galas › 2027** (empty folder) `list_id: lst_f0ld3r27`

Lists are grouped by folder. A folder is part of each list's name (`Galas//2024 Gala Attendees`); an empty folder is kept by a placeholder named `Galas//2027//.`, shown here with its id so it can be renamed or deleted.

remove_from_list

Remove people from a donor list by person ID.

ParameterTypeRequiredDefault
list_idstringyes
person_idsarray of stringyes
Example response (1)
response
The people you passed are no longer on [the donor list](https://app.donoratlas.com/donor_lists/lst_2024gala/1).

rename_list

Rename a donor list, or move it to another folder by renaming it with its new full path. Folders live in a list's name, separated by `//`: `Galas//2026//Spring Gala` is the list "Spring Gala" in the folder "Galas › 2026". Show paths to the user with ›, not the raw `//`. A folder has no name of its own: to rename or move one, rename every list in it, including its empty-folder placeholder (`Old//.` to `New//.`).

ParameterTypeRequiredDefault
list_idstringyes
new_namestringyes
Example response (1)
response
Renamed [the donor list](https://app.donoratlas.com/donor_lists/lst_9k2m4x7q/1) to **Galas › 2026 › Gala Prospects**.

Renaming with a new `//` path moves the list between folders.

Notes

add_note

Add a note to a person's profile, visible to everyone on the team. To read notes, use get_person_profile with full=true.

ParameterTypeRequiredDefault
person_idstringyes
textstringyes
Example response (1)
response
Added a note to [this person's profile](https://app.donoratlas.com/donor/da_7f3k2m9x) `note_id: 5b0c2e7a-91d4-4f3e-8a26-0d4c7e1b9f52`.

delete_note

Permanently delete a note, by its note_id from the full profile. Confirm with the user first: it may be a teammate's, and it can't be restored.

ParameterTypeRequiredDefault
note_idstringyes
Example response (1)
response
Deleted note `5b0c2e7a-91d4-4f3e-8a26-0d4c7e1b9f52`.

Confirm with the user first; a deleted note can't be restored.

edit_note

Replace a note's text, by its note_id from the full profile. Check who wrote it before changing a teammate's note.

ParameterTypeRequiredDefault
note_idstringyes
textstringyes
Example response (1)
response
Updated note `5b0c2e7a-91d4-4f3e-8a26-0d4c7e1b9f52` on [this person's profile](https://app.donoratlas.com/donor/da_7f3k2m9x).

Any teammate's note can be edited; the full profile shows who wrote each one.

Imports

import_people

Import a spreadsheet of people into a new donor list: each row is matched to a donor profile, or researched when there is none. Use it when the user hands you a set of people to research or keep together. Pass the file as `csv` text with its header row first, and `column_mapping` from the fields below to the header's column names, spelled exactly as in the header; unmapped columns are ignored. Fields: FULL_NAME; FIRST_NAME; MIDDLE_NAME; LAST_NAME; SUFFIX (Jr., Sr., III); NICKNAME (other first names the person goes by, list); EMPLOYER (employer, list); OCCUPATION (job title, list); SCHOOL (school attended, list); NONPROFIT_AFFILIATION (a nonprofit this person is connected to, list); ADDRESS1 (street address); ADDRESS1_LINE_2 (second address line); CITY1 (city); STATE1 (state); ZIP_CODE1 (zip code); ADDRESS2 (a second address's street); ADDRESS2_LINE_2; CITY2; STATE2; ZIP_CODE2; LINKEDIN (LinkedIn profile URL); SPOUSE_FULL_NAME; SPOUSE_FIRST_NAME; SPOUSE_LAST_NAME. Fields marked list take a list of column names, even for one column; the rest take one column name. A mapping needs FULL_NAME, or FIRST_NAME and LAST_NAME, plus at least one more identifying field (NICKNAME, SUFFIX and MIDDLE_NAME don't count). `name` is the new donor list's name; `//` puts it in folders (`Galas//2026//Spring Gala`). A file over 10,000 rows is imported by hand by the DonorAtlas team within about a day. For a large file, or one the user already has as a spreadsheet, consider suggesting they import it in the DonorAtlas app, where they can review the mapping. Matching runs in the background: get_list shows the people as they arrive, and list_lists marks the donor list as still filling until the import is done.

ParameterTypeRequiredDefault
namestringyes
csvstringyes
column_mappingobjectyes
Example responses (4)
import started
Importing 248 people into the donor list **[Galas › 2026 › Spring Gala](https://app.donoratlas.com/donor_lists/1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13/1)** `list_id: 1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13`, one import credit each. They appear as they are matched or researched, which takes a while for a large file: get_list(list_id="1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13") shows them, and list_lists marks the donor list as still filling until the import is done.

[Open the donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13/1) — include this link in your reply.

Called with name "Galas//2026//Spring Gala" and column_mapping {"FIRST_NAME": "First", "LAST_NAME": "Last", "EMPLOYER": ["Company"], "CITY1": "City", "STATE1": "State"}. Fields that can take several columns (EMPLOYER, OCCUPATION, SCHOOL, NICKNAME, NONPROFIT_AFFILIATION) are always given a list.

mapping refused
Nothing was imported: The column mapping names 'Company Name', but that column isn't in the file's header row. The file's columns are: 'First', 'Last', 'Company', 'City', 'State'. Map each field to one of those names, exactly as written.

Nothing is created or charged; fix the mapping and call again with the same name.

not enough credits
Nothing was imported: the file has 1,200 rows, one import credit each, and the team has only 880 import credits left. Import 880 rows or fewer. For more import credits, ask a team admin or contact team@donoratlas.com.
over 10,000 rows
The file has 14,500 rows, over the 10,000 an import processes automatically, so the DonorAtlas team will import it by hand: the donor list **[Alumni Donors](https://app.donoratlas.com/donor_lists/1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13/1)** `list_id: 1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13` fills in within about 24 hours, at no import credit cost.

[Open the donor list in DonorAtlas](https://app.donoratlas.com/donor_lists/1f6c2a9e-7b3d-4e8a-9c51-0d2e4f6a8b13/1) — include this link in your reply.

Networks

add_to_network

Add people to a network: pass person_ids, or from_list_id with no person_ids to add everyone on a donor list.

ParameterTypeRequiredDefault
network_idstringyes
person_idsarrayno
from_list_idstringno
Example responses (2)
small add (sync)
Added 3 people to [the network](https://app.donoratlas.com/network/net_5t7y9u1i).
large add (async)
Adding 40 people to [the network](https://app.donoratlas.com/network/net_5t7y9u1i) in the background; their connections appear over the next few minutes.

Background jobs: `job_c92d51e8`, `job_d03e62f9`

Above ~5 people the backend chunks the add into background jobs; connection discovery lands over the following minutes.

create_network

Create a network. color is one of: blue, indigo, violet, rose, orange, amber, green, teal.

ParameterTypeRequiredDefault
namestringyes
colorstringno"blue"
Example response (1)
response
Created network **[Gala Connections](https://app.donoratlas.com/network/net_5t7y9u1i)** `network_id: net_5t7y9u1i`.

[Open the network in DonorAtlas](https://app.donoratlas.com/network/net_5t7y9u1i) — include this link in your reply.

delete_network

Delete a network permanently. Confirm with the user first.

ParameterTypeRequiredDefault
network_idstringyes
Example response (1)
response
Deleted network `net_5t7y9u1i`.

get_network

Get a network's members, a page at a time. page_size: up to 25 = full rows; 26-100 = name, link and ID only.

ParameterTypeRequiredDefault
network_idstringyes
pageintegerno1
page_sizeintegerno20
Example response (1)
response
## [Network: Museum Board Map](https://app.donoratlas.com/network/net_boardmap)
`network_id: net_boardmap`
**74 people match** (page 1, 20 shown):
- **[Robert Smith](https://app.donoratlas.com/donor/da_7f3k2m9x)** — Chicago, IL — …

[Open this network in DonorAtlas](https://app.donoratlas.com/network/net_boardmap) — include this link in your reply.

page_size goes up to 100, with rows trimmed to name, link and ID above 25. Each page counts as one search.

list_networks

List the team's networks.

Example response (1)
response
## Networks (1)
- **[Museum Board Map](https://app.donoratlas.com/network/net_boardmap)** `network_id: net_boardmap` — 74 people

remove_from_network

Remove people from a network.

ParameterTypeRequiredDefault
network_idstringyes
person_idsarray of stringyes
Example response (1)
response
Started removing 3 people from [the network](https://app.donoratlas.com/network/net_5t7y9u1i). It runs in the background for a few minutes, and get_network may still show them until it finishes.

rename_network

Rename a network.

ParameterTypeRequiredDefault
network_idstringyes
new_namestringyes
Example responses (2)
response
Renamed [the network](https://app.donoratlas.com/network/net_5t7y9u1i) to **Gala Connections 2026**.
name taken
Your team already has a network named "Museum Board Map", so nothing was renamed. Pick another name.

Exports

export_grants

Export every grant a nonprofit reported making on its IRS filings to CSV or XLSX: one row per grant, with the recipient as filed and as matched in DonorAtlas. Free: it spends no export credits. Pass the nonprofit's entity_id (`npo_…`) as a search, profile or get_entity_profile printed it. recipient_type limits the export to recipients of one type, written exactly as get_entity_profile's grants section prints it. Omitting fields exports the default columns; run with check_only=true to see every column name fields accepts. It always runs in the background: poll get_export_status for the download link.

ParameterTypeRequiredDefault
namestringyes
entity_idstringyes
file_formatstringno"csv"
fieldsarrayno
recipient_typestringno
check_onlybooleannofalse
Example responses (3)
column check
Grants exports are free: they spend no export credits.

Default columns: Tax Year, Amount, Purpose, Recipient Name, Recipient City, Recipient State, Recipient EIN, Recipient DonorAtlas URL, Recipient Type.

Other columns (request by name in fields, in the order to write them):
- The grant: Form Type (The IRS form that reported the grant, such as 990 or 990PF.)
- Recipient, as filed: Recipient Name (as filed); Recipient Address; Recipient ZIP; Recipient Tax Status (As the grantor wrote it, such as 501(c)(3). Often blank.)
- Recipient, matched in DonorAtlas: Recipient NTEE Code; Recipient Mission; Recipient Website; …
- Grantor: Grantor Name; Grantor EIN

check_only=true — nothing is exported. The recipient types recipient_type accepts are printed in get_entity_profile's grants section.

started
Grants exports are free: no export credits were spent. Status: processing in the background; the user is also emailed a link when it finishes. Poll get_export_status with `export_id: exp_7k2m4n6p` for the download link.

Every grants export runs in the background, however few grants it holds.

no grants of that type
Nothing was exported: `npo_1a2b3c4d` reported no grants to recipients of type "Hospitals". The type must be written exactly as get_entity_profile's grants section prints it; leave recipient_type out to export every grant.

export_people

Export people to CSV or XLSX. Pass list_id (a whole list) or person_ids (up to 100 people; for more, put them on a list and export that) — one, not both. Omitting fields exports the default columns; any other column, including a list's own uploaded ones, is opt-in by name in fields. Requesting a contact column reveals contact info for everyone exported. Run with check_only=true first to see the credit cost and every column name fields accepts. Large exports run in the background: poll get_export_status for the download link.

ParameterTypeRequiredDefault
namestringyes
list_idstringno
person_idsarrayno
file_formatstringno"csv"
fieldsarrayno
check_onlybooleannofalse
Example responses (4)
credit check
This export needs 44 export credits; the team has enough.

Default columns: DonorAtlas URL, Title, First, Middle, Last, …, Net Worth (Min), Net Worth (Max), Nonprofit Boards, Spouse, Parents, Children. DonorAtlas URL is always included: first, unless fields puts it elsewhere.

Opt-in columns (request by name; contact columns reveal contact info for everyone exported): Research Links, Verified Mobile Phone, Best Verified Email, Verified Personal Emails, Verified Work Emails, Other Emails, Other Phones, All Schools, LinkedIn, Nonprofit Largest Gift (Min), In-Network Connections, Connection Explanations

Columns uploaded with this list (opt-in): Gift Officer, Ask Amount

check_only=true — nothing is charged. Pass list_id for a whole list (which also offers the list's uploaded columns) or person_ids for up to 100 people. Omitting fields exports the default columns; contact columns and uploaded columns must be requested by name.

ready (small)
Status: ready — [download it here](https://exports.donoratlas.com/…(presigned)) (link valid 30 minutes; get_export_status gives one valid 7 days). `export_id: exp_3f5g7h9j`
processing (large)
Status: processing in the background; the user is also emailed a link when it finishes. Poll get_export_status with `export_id: exp_3f5g7h9j` for the download link.

Exports above 10 rows always run in the background — size decides, not the caller.

insufficient credits
Nothing was exported: this export needs 4,400 export credits, more than the team has. Export fewer people, or ask a team admin about more export credits.

get_export_status

Check an export and get its download link once it's ready.

ParameterTypeRequiredDefault
export_idstringyes
Example responses (2)
processing
Status: still processing — check again shortly with `export_id: exp_3f5g7h9j`.
ready
Status: ready — [download it here](https://exports.donoratlas.com/…(presigned)) (link valid 7 days).

list_exports

List the team's past exports, newest first, with each one's status. For a download link, call get_export_status with its export_id.

ParameterTypeRequiredDefault
pageintegerno1
page_sizeintegerno20
Example response (1)
response
## Exports (23)
- **Gala prospects** — 2026-10-12 by Jordan Ellis — 312 people — XLSX — ready `export_id: exp_3f5g7h9j`
- **Board candidates** — 2026-10-09 by Dana Cho — 40 people — CSV — processing `export_id: exp_8a1b2c3d`
- **Q3 outreach** — 2026-09-30 by Dana Cho — 1,200 people — CSV — failed: Not enough export credits. `export_id: exp_0z9y8x7w`

*Page 1 of 8 (23 rows in all).*

Call get_export_status with an `export_id` for its download link.

Newest first, 20 per page by default (up to 100). No download links: get_export_status mints one.