# GlobalGiving MCP MCP

> GlobalGiving searches thousands of global nonprofit projects and charities using your AI agent. You can research impact by theme, country, or specific cause like education or health. This MCP gives you direct access to project goals, funding progress, and vetted organization details from one place.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** crowdfunding, charity-research, nonprofit-management, impact-tracking, social-impact, project-discovery

## Description

Need to track down a charity's history or check the current fundraising status of a grassroots project? Connect your AI agent to GlobalGiving via Vinkius for immediate research. Instead of bouncing between multiple global portals, you can ask simple questions—like 'Show me all active health initiatives in Kenya.' Your agent handles the complex searching and filtering against thousands of records. You get real-time data on project progress, funding gaps, and organization profiles without ever leaving your main workspace. This lets CSR leads or impact researchers gather verified facts instantly, making deep philanthropic research as simple as a conversation.

## Tools

### verify_api_connection
Confirms that your connection credentials and API key are set up correctly.

### get_charity_details
Retrieves official metadata and profile information for a specific nonprofit organization.

### get_project_details
Fetches comprehensive data, including funding goals, for an individual project.

### list_all_projects
Lists every available non-profit project record in the database.

### list_projects_by_country
Retrieves a list of projects based on their geographical location or ISO country code.

### list_charity_projects
Shows all projects associated with a single, specified nonprofit organization.

### list_projects_by_theme
Filters and lists projects that fall under a specific impact category or theme.

### list_project_themes
Provides an exhaustive list of available impact themes (e.g., women's empowerment, disaster recovery).

### find_education_initiatives
Searches for and retrieves details on educational non-profit projects.

### find_environment_initiatives
Searches for and retrieves details on environmental conservation projects.

### find_health_initiatives
Searches for and retrieves details on public health-focused initiatives.

### search_nonprofit_projects
Conducts broad searches across all available fields for non-profit initiatives using keywords, themes, or countries.

## Prompt Examples

**Prompt:** 
```
Search for education projects in Brazil (BR).
```

**Response:** 
```
Searching projects... I found 5 active education initiatives in Brazil, including 'Digital Literacy for Youth' and 'School Supplies for Rural Areas'. Would you like the goal progress for any of them?
```

**Prompt:** 
```
List all active projects for the organization ID '12345'.
```

**Response:** 
```
Retrieving projects... For organization 12345, I found 3 active projects: 'Clean Water for All', 'Solar Power Inititative', and 'Health Clinic Support'.
```

**Prompt:** 
```
Find environment projects that need less than $1000 to reach their goal.
```

**Response:** 
```
Filtering projects... I found 2 environmental initiatives near their goals: 'Reforestation in Kenya' (Remaining: $450) and 'Ocean Cleanup Program' (Remaining: $820).
```

## Capabilities

### Find Specific Initiatives
Search for projects in targeted fields like education, environment, or health.

### Review Organization Profiles
Get detailed mission statements and background information on vetted global charities.

### Map Projects by Location/Topic
List all active projects filtered by a specific country or impact theme.

### Retrieve Project Status
Get detailed metadata on a single project, including its goal progress and funding status.

## Use Cases

### Vetting a New Partner
A CSR Manager needs to know about local health efforts in Uganda. They prompt the agent, which uses `find_health_initiatives` and then applies `list_projects_by_country` (Uganda) to generate a filtered list of options for immediate review.

### Building an Impact Report
An Impact Researcher needs data showing global efforts in climate action. They run `list_project_themes` first, confirming 'Climate Action,' and then use that theme to pull relevant projects via `list_projects_by_theme` for the report.

### Tracking a Known Charity
A Program Officer needs all current projects for an established group. They call `list_charity_projects` using the organization ID, which immediately shows every active initiative without manual navigation.

### Quick Scope Check
Someone just wants a general overview of everything available globally. They use `list_all_projects` to see the total scope of initiatives before narrowing down their focus with keyword searches using `search_nonprofit_projects`.

## Benefits

- Deep Dive into Funding Status: Instead of guessing, you can use the `get_project_details` tool to pull real-time numbers on how close a project is to hitting its goal. You see total amounts raised and exactly how much more cash is needed.
- Targeted Discovery: Don't waste time scrolling through thousands of entries. Use specialized search tools like `find_education_initiatives` or `list_projects_by_theme` to filter results instantly by your focus area.
- Organization Vetting: Before committing resources, use `get_charity_details` to pull official metadata on a nonprofit group. This ensures your research is backed by verified information.
- Comprehensive Coverage: Need broad scope? Use the general `search_nonprofit_projects` tool. It handles complex queries across multiple parameters like theme and country in one go.
- Contextual Tracking: If you already know an organization, use `list_charity_projects` to see everything they're working on without having to visit their main website.

## How It Works

The bottom line is you can gather verifiable global charity data using simple conversation prompts.

1. First, subscribe to the GlobalGiving MCP through Vinkius and input your unique API key from the developer portal.
2. Next, prompt your AI agent with a specific query—for example, 'List all education projects in Brazil.'
3. Your agent executes the search against the GlobalGiving data and returns structured information on active initiatives, goals, and progress.

## Frequently Asked Questions

**How do I get an API Key for GlobalGiving?**
Go to the GlobalGiving API website (globalgiving.org/api/) and request a free API key by filling out their registration form.

**Are all organizations on GlobalGiving vetted?**
Yes, GlobalGiving performs rigorous due diligence on all nonprofit partners to ensure they are high-impact and transparent.

**Can I search for projects using ISO country codes?**
Yes! Use the 'list_projects_by_country' tool and provide a standard 2-letter ISO code (e.g., 'BR' for Brazil or 'US' for the USA).

**What themes are available for filtering?**
Common themes include 'edu' (education), 'env' (environment), 'health', 'disaster' (disaster recovery), and 'women' (women and girls).

**What are the rate limits when using the `search_nonprofit_projects` tool?**
The MCP manages standard API throttling automatically. For high-volume research across many regions, you should check the GlobalGiving developer portal for specific call quotas and usage best practices.

**Does `list_all_projects` return only active initiatives, or does it include historical data?**
The tool returns metadata for all projects associated with an organization ID. If you need to track only currently funded goals, run a targeted search using the `search_nonprofit_projects` command instead.

**How do I check the real-time financial status of a project using `get_project_details`?**
The tool provides detailed metrics on goal progress. You'll get live figures, including the total amount raised and how much funding remains needed to hit the target.

**If my keyword search is too broad, what should I do before running `search_nonprofit_projects`?**
It’s best practice to narrow your focus by combining multiple parameters like themes or specific country codes. The agent will flag ambiguous results and prompt you to refine the input for better data.