# nonprofit-explorer-mcp-server

MCP-сервер nonprofit-explorer-mcp-server для поиска по базе некоммерческих организаций США и выгрузки налоговой отчётности IRS Form 990 через API ProPublica.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1281 установка · ★ 2 у репозитория
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/nonprofit-explorer-mcp-server
- Обновлён: 2026-10-22
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/nonprofit-explorer-mcp-server

## Что делает

Сервер подключает LLM к данным ProPublica Nonprofit Explorer, охватывающим более 1.8 миллиона американских налогонеоблагаемых структур. Ассистент получает три инструмента: полнотекстовый поиск с фильтрами по штатам, кодам 501(c) и категориям NTEE, получение карточки организации по номеру EIN, а также загрузку архива деклараций Form 990 с разбивкой доходов, расходов и ссылками на оригинальные PDF.

Поиск выдаёт до 25 результатов на страницу с потолком пагинации в 10 000 записей. Номер EIN принимается в виде числа или строки с дефисом, после чего сервер декодирует официальный статус IRS, включая право на налоговые вычеты и тип фонда.

Финансовые показатели в базе ProPublica отстают от текущего календаря на 1–2 года, поэтому при выводе цифр критично сверять fiscal year (`tax_prd_yr`). Показатель доли программных расходов `program_expense_ratio` в выгрузках всегда равен `null`, так как API не отдаёт сумму расходов по разделу IX формы.

## Требования
- Удалённый сервер: `https://nonprofit-explorer-mcp-server--cyanheads.run.tools`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add nonprofit-explorer-mcp-server --url https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nonprofit-explorer-mcp-server": {
            "url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "nonprofit-explorer-mcp-server": {
            "type": "http",
            "url": "https://nonprofit-explorer-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http nonprofit-explorer-mcp-server https://nonprofit-explorer-mcp-server--cyanheads.run.tools
```

## Когда брать
- найти американскую некоммерческую организацию по названию или ключевым словам
- проверить статус освобождения от налогов и классификацию фонда по номеру EIN
- выгрузить динамику активов, выручки и зарплат руководства из деклараций Form 990
- получить прямые ссылки на исходные PDF-файлы налоговых отчётностей IRS

## Примеры запросов агенту
- Найди благотворительные фонды помощи животным в штате Иллинойс через инструмент `nonprofit_search_organizations`
- Запроси профиль организации с EIN `53-0196605` и покажи её активы за последний доступный год
- Выгрузи историю сдачи Form 990 для фонда и сравни доходы от пожертвований за последние пять периодов

## Похожие
- [tres-explorer-tx-to-ledger](https://affpapa.org/nevibecode/skills/tres-explorer-tx-to-ledger.md) — скилл · ★ 4931 у репозитория
- [Granted](https://affpapa.org/nevibecode/mcp/granted.md) — MCP-сервер · 2545 установок
- [stock-info-explorer](https://affpapa.org/nevibecode/skills/stock-info-explorer.md) — скилл · 509 установок
- [decision-tree-explorer](https://affpapa.org/nevibecode/commands/decision-tree-explorer.md) — команда · 291 установка
- [business-scenario-explorer](https://affpapa.org/nevibecode/commands/business-scenario-explorer.md) — команда · 273 установки
- [tooluniverse-gwas-study-explorer](https://affpapa.org/nevibecode/skills/tooluniverse-gwas-study-explorer.md) — скилл · 363 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
