{"_id":"@ainative/institutionos-mcp","_rev":"3-1bd200bfcdebc1dedbc79d465d5a97a5","name":"@ainative/institutionos-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@ainative/institutionos-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","ainative","institutionos","nonprofit","agents","grants","claude","ai-agents","zerodb"],"license":"MIT","_id":"@ainative/institutionos-mcp@1.0.0","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"homepage":"https://ainative.studio/agent-cloud","bugs":{"url":"https://github.com/AINative-Studio/ainative-ngo/issues"},"bin":{"institutionos-mcp":"index.js"},"dist":{"shasum":"073c81de180de3d1f2bdbcc1614b34df0d32786a","tarball":"https://registry.npmjs.org/@ainative/institutionos-mcp/-/institutionos-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-fG65UZzaAD5aRlB5cIcH60sQ/FcyEO/RVU9g54qiLAfbii0PgjbF4Jr92ftfqv68wq2OhLqtSTpOvYgD39CV5g==","signatures":[{"sig":"MEUCIB7BnEz9ta4WURQs+bJcq35iWn1ZmOLYrthpMhMsdndUAiEAxb+OASHOhdHf5hifuStjKqFxc9KIjxLf+znN5Fsqym0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15508},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"869c297f40553e0fd62cecfc2d42f6df88b8b638","scripts":{"start":"node index.js"},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/ainative-ngo.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.4","description":"MCP server exposing InstitutionOS capabilities — AI agents, federal grants, data connectors, governance, and memory for nonprofits","directories":{},"_nodeVersion":"22.21.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/institutionos-mcp_1.0.0_1781239151600_0.9270307103395024","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@ainative/institutionos-mcp","version":"1.1.0","keywords":["mcp","mcp-server","mcp-tools","model-context-protocol","claude-mcp-server","claude-desktop-mcp","nonprofit-software","nonprofit-management-software","nonprofit-accounting-software","nonprofit-crm","nonprofit-compliance","grant-writing-software","ai-grant-writer","grants-gov-search","federal-grants-search","federal-grants-api","nonprofit-ai-agent","ai-nonprofit-tools","nonprofit-automation","501c3-management","nonprofit-data-analytics","ai-for-nonprofits","nonprofit-technology","foundation-management","institutional-ai","ai-agents","ainative","institutionos","zerodb","nonprofit-governance","grant-research-tool"],"license":"MIT","_id":"@ainative/institutionos-mcp@1.1.0","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"homepage":"https://ainative.studio/agent-cloud","bugs":{"url":"https://github.com/AINative-Studio/ainative-ngo/issues"},"bin":{"institutionos-mcp":"index.js"},"dist":{"shasum":"c83b8b5dab659eb576787ebd9c5b9b8593421bfa","tarball":"https://registry.npmjs.org/@ainative/institutionos-mcp/-/institutionos-mcp-1.1.0.tgz","fileCount":3,"integrity":"sha512-YhU+XtHTrtNRRB6ozVR19oWO4B8lYv60lhrLUIhKSeDHtwQxfyC15H1G+ecDNv7RE1CyXg2HKUlQqMiA8KU9Ng==","signatures":[{"sig":"MEUCIH9NL+ULERhX/7lPiUXQJJKyDJroMswFon/SzJju3ydTAiEAwTIviVN4A2CPGjDQvX7HtTvJ9UnQCVqmJVD03q1UP4M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20355},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6cc8213858680a8c29a75a17acc1cb998dd9b984","scripts":{"start":"node index.js"},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/ainative-ngo.git","type":"git","directory":"mcp-server"},"_npmVersion":"10.9.4","description":"MCP server for nonprofit management — AI agents, federal grants search (Grants.gov + USAspending), nonprofit accounting, compliance, grant writing, and 501(c)(3) operations via Claude Desktop, Claude Code, and Cursor","directories":{},"_nodeVersion":"22.21.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/institutionos-mcp_1.1.0_1781245805594_0.2737797980073631","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@ainative/institutionos-mcp","version":"1.2.0","description":"MCP server for nonprofit management — AI agents, federal grants search (Grants.gov + USAspending), nonprofit accounting, compliance, grant writing, and 501(c)(3) operations via Claude Desktop, Claude Code, and Cursor","type":"module","bin":{"institutionos-mcp":"index.js"},"main":"index.js","scripts":{"start":"node index.js"},"keywords":["mcp","mcp-server","mcp-tools","model-context-protocol","claude-mcp-server","claude-desktop-mcp","nonprofit-software","nonprofit-management-software","nonprofit-accounting-software","nonprofit-crm","nonprofit-compliance","grant-writing-software","ai-grant-writer","grants-gov-search","federal-grants-search","federal-grants-api","nonprofit-ai-agent","ai-nonprofit-tools","nonprofit-automation","501c3-management","nonprofit-data-analytics","ai-for-nonprofits","nonprofit-technology","foundation-management","institutional-ai","ai-agents","ainative","institutionos","zerodb","nonprofit-governance","grant-research-tool"],"repository":{"type":"git","url":"git+https://github.com/AINative-Studio/ainative-ngo.git","directory":"mcp-server"},"homepage":"https://ainative.studio/agent-cloud","bugs":{"url":"https://github.com/AINative-Studio/ainative-ngo/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"engines":{"node":">=18.0.0"},"license":"MIT","publishConfig":{"access":"public"},"_id":"@ainative/institutionos-mcp@1.2.0","gitHead":"b9956845e472353770770110cff1e125981ae1ad","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-8XPljaGyGViaCXU+yfUSdClluFV2yg+Cj3UQLh7PNEaxHrbIhA6uJs8LMbf09ae8QlED78ULlmK+PbZHfza/gw==","shasum":"7ddd13870390153645222d11db81aba21bd8b788","tarball":"https://registry.npmjs.org/@ainative/institutionos-mcp/-/institutionos-mcp-1.2.0.tgz","fileCount":3,"unpackedSize":28291,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHYa17jttFW3qEyRL4Yu0ZVeUg4QeMfDJko76E9xEHcRAiAMD+e7Ff9P3gHZdzScR83m/F1A3CPtNRjxO16nSJFeOQ=="}]},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"directories":{},"maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/institutionos-mcp_1.2.0_1781246476758_0.7376976990387536"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-12T04:39:11.433Z","modified":"2026-06-12T06:41:17.027Z","1.0.0":"2026-06-12T04:39:11.743Z","1.1.0":"2026-06-12T06:30:05.726Z","1.2.0":"2026-06-12T06:41:16.887Z"},"bugs":{"url":"https://github.com/AINative-Studio/ainative-ngo/issues"},"license":"MIT","homepage":"https://ainative.studio/agent-cloud","keywords":["mcp","mcp-server","mcp-tools","model-context-protocol","claude-mcp-server","claude-desktop-mcp","nonprofit-software","nonprofit-management-software","nonprofit-accounting-software","nonprofit-crm","nonprofit-compliance","grant-writing-software","ai-grant-writer","grants-gov-search","federal-grants-search","federal-grants-api","nonprofit-ai-agent","ai-nonprofit-tools","nonprofit-automation","501c3-management","nonprofit-data-analytics","ai-for-nonprofits","nonprofit-technology","foundation-management","institutional-ai","ai-agents","ainative","institutionos","zerodb","nonprofit-governance","grant-research-tool"],"repository":{"type":"git","url":"git+https://github.com/AINative-Studio/ainative-ngo.git","directory":"mcp-server"},"description":"MCP server for nonprofit management — AI agents, federal grants search (Grants.gov + USAspending), nonprofit accounting, compliance, grant writing, and 501(c)(3) operations via Claude Desktop, Claude Code, and Cursor","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"readme":"# Nonprofit MCP Server — AI Agents, Federal Grants, Compliance & Accounting\n\nThe first **MCP server built for nonprofits**. Connect Claude Desktop, Claude Code, or Cursor to a full nonprofit management platform with AI agents, federal grant search (Grants.gov + USAspending), 501(c)(3) compliance, fund accounting, and 11 federal data connectors.\n\n**17 tools** for nonprofit operations, grant writing, donor management, governance, and institutional memory — all accessible via the [Model Context Protocol](https://modelcontextprotocol.io).\n\n## Quick Start\n\n```bash\nnpx @ainative/institutionos-mcp\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"nonprofit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ainative/institutionos-mcp\"],\n      \"env\": {\n        \"AINATIVE_NGO_API_KEY\": \"your-api-key\",\n        \"DEFAULT_INSTITUTION_ID\": \"your-institution-id\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add nonprofit -- npx -y @ainative/institutionos-mcp\n```\n\n### Cursor\n\nAdd to MCP settings with the same config as Claude Desktop.\n\n## What You Can Do\n\n**Ask Claude to:**\n- \"Search for federal grants related to STEM education for nonprofits\"\n- \"Run the grant writer agent to draft a proposal for this NSF opportunity\"\n- \"Check our 501(c)(3) tax compliance status\"\n- \"Sync the latest grants from Grants.gov and USAspending\"\n- \"What are the funding trends for education grants over the last 5 years?\"\n- \"Evaluate whether our AI agent should approve this $50K expense\"\n- \"Search our institutional memory for past board decisions about DEI programs\"\n\n## Available Tools (17)\n\n### AI Agent Operations\n| Tool | Description |\n|------|-------------|\n| `ngo_run_agent` | Run an AI agent — 12 roles: grant writer, fund accountant, case manager, tax specialist, crisis communicator, advocacy campaigner, DEI officer, revenue strategist, partnership manager, board secretary, policy researcher, program designer |\n| `ngo_list_roles` | List all available agent roles |\n\n### Federal Grants (Grants.gov + USAspending)\n| Tool | Description |\n|------|-------------|\n| `ngo_search_grants` | Search 82,000+ federal grant opportunities — filter by keyword, status, eligibility, agency |\n| `ngo_sync_grants` | Sync all grants into the AINative data lakehouse (posted, closed, archived, forecasted) |\n| `ngo_list_opportunities` | Browse synced grant opportunities with filters |\n| `ngo_grant_trends` | Analyze funding trends — yearly totals, average award size, top agencies by CFDA |\n\n### Federal Data Connectors (11 Sources)\n| Tool | Description |\n|------|-------------|\n| `ngo_sync_federal_data` | Sync all 11 data sources at once — IRS, Census, FRED, SEC, BLS, ProPublica, Regulations.gov, OpenStates, Semantic Scholar, USAspending |\n| `ngo_sync_source` | Sync a specific source (e.g., \"irs-bmf\", \"census\", \"fred\", \"sec\", \"research\") |\n\n### Nonprofit Operations\n| Tool | Description |\n|------|-------------|\n| `ngo_create_institution` | Register a new nonprofit institution |\n| `ngo_list_institutions` | List all registered institutions |\n| `ngo_provision_memory` | Set up 59 memory tables for a new institution |\n| `ngo_search_memory` | Semantic search across institutional memory |\n| `ngo_store_memory` | Store knowledge, decisions, or context in institutional memory |\n\n### Governance & Compliance\n| Tool | Description |\n|------|-------------|\n| `ngo_evaluate_action` | Evaluate any agent action against governance policies (permissions, risk scoring, audit trail) |\n| `ngo_check_compliance` | Run 501(c)(3) tax compliance check — filings, state registrations, deadlines |\n\n### Health\n| Tool | Description |\n|------|-------------|\n| `ngo_health` | Check backend API health |\n\n## Data Sources\n\nThe platform connects to **11 free federal data sources** that flow into the AINative data lakehouse:\n\n| Source | Data | Records |\n|--------|------|---------|\n| **Grants.gov** | Federal grant opportunities (open, closed, archived) | 82,000+ |\n| **USAspending.gov** | Grant award data (amounts, recipients, agencies) | 343,000+ |\n| **IRS BMF** | Every tax-exempt organization in the US | 1,700,000+ |\n| **ProPublica** | Nonprofit 990 filings (revenue, expenses, assets) | 1,800,000+ |\n| **Census ACS** | Demographics by state, county, and tract | All US geographies |\n| **FRED** | Economic indicators (GDP, unemployment, CPI) | 800,000+ series |\n| **SEC EDGAR** | Company filings, Form D, XBRL financials | All public filings |\n| **Semantic Scholar** | Academic papers, citations, authors | 200,000,000+ |\n| **BLS** | Employment, wages, CPI by area | All states/counties |\n| **Regulations.gov** | Federal rulemaking documents | 500,000+ |\n| **OpenStates** | State legislation tracking | All 50 states |\n\n## Architecture\n\n```\nClaude Desktop / Code / Cursor\n        |\n        | MCP (stdio, JSON-RPC)\n        v\n  @ainative/institutionos-mcp\n        |\n        | HTTP REST\n        v\n  ┌─────────────────────┐     ┌──────────────────────┐\n  | Backend API          |     | Agent Runtime         |\n  | ngo.ainative.studio  |     | (12 AI agents on      |\n  | FastAPI + Python     |     |  @ainative/agent-      |\n  | 200+ endpoints       |     |  runtime + GPT-4o)    |\n  └────────┬────────────┘     └──────────────────────┘\n           |\n           v\n  ┌─────────────────────┐\n  | AINative Lakehouse   |\n  | MinIO + Parquet      |\n  | 160K+ rows, 14       |\n  | datasets from 11     |\n  | federal data sources  |\n  └─────────────────────┘\n```\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `NGO_API_URL` | `https://ngo.ainative.studio/api/v1` | Backend API URL |\n| `NGO_AGENT_URL` | `https://institutionos-agents-production.up.railway.app` | Agent server URL |\n| `AINATIVE_NGO_API_KEY` | — | API key for authentication |\n| `DEFAULT_INSTITUTION_ID` | `ainative-foundation` | Default institution ID |\n\n## Built With\n\n- [AINative Agent Cloud](https://ainative.studio/agent-cloud) — Agent execution platform\n- [@ainative/agent-runtime](https://www.npmjs.com/package/@ainative/agent-runtime) — Embeddable agent engine\n- [ZeroDB](https://docs.ainative.studio) — Unified data platform\n- [Model Context Protocol](https://modelcontextprotocol.io) — Anthropic's agent-to-tool standard\n\n## License\n\nMIT\n","readmeFilename":"README.md"}