MCP_NSF_Awards

jhalsey87/MCP_NSF_Awards

3.2

If you are the rightful owner of MCP_NSF_Awards and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The NSF Awards API MCP Server provides access to the National Science Foundation's awards data, enabling users to search, retrieve, and analyze information about NSF-funded research projects.

Tools
5
Resources
0
Prompts
0

NSF Awards API MCP Server

Model Context Protocol (MCP) server that provides access to the National Science Foundation (NSF) Awards API.

Features

This MCP server enables Claude to:

  • Search for NSF-funded research awards
  • Retrieve detailed information about specific awards
  • Access project outcomes and results
  • Analyze funding trends and patterns across multiple awards
  • Query by keywords, investigators, organizations, dates, and more

Tools

Core Tools

  1. search_awards - Search for NSF awards with comprehensive filtering options

    • Keywords with Boolean operators (AND, OR, NOT)
    • Award dates and date ranges
    • Funding amounts
    • Organization names and locations
    • Principal investigator names
    • Directorate and division codes
    • Award status

  2. get_award_details - Get complete information about a specific award by ID

  3. get_project_outcomes - Retrieve public outcomes from completed NSF projects

Efficiency Tools

  1. search_awards_light - Lightweight search returning only essential fields

    • Reduces response size for large result sets
    • Returns: id, title, funding amount, dates, awardee, PI names

  2. analyze_award_trends - Server-side trend analysis and aggregation

    • Processes up to 3000 awards server-side
    • Returns aggregated summaries including:
      • Total awards and funding statistics
      • Distribution by NSF directorate/agency
      • Top organizations by funding
      • Funding trends by year
      • Common research themes from titles
    • Designed to avoid context limits when analyzing large datasets

Installation

Using Docker (Recommended)

  1. Build the Docker image:
docker build -t nsf-awards-mcp .
  1. Add to Claude Code:
claude mcp add --transport stdio -s user nsf-awards -- docker run -i --rm nsf-awards-mcp

Using Python Directly

  1. Install dependencies:
pip install -r requirements.txt
  1. Add to Claude Code:
claude mcp add --transport stdio -s user nsf-awards -- python /path/to/server.py

Usage Examples

Search for awards by keyword

Find recent NSF awards related to machine learning

Analyze funding trends

What are the funding trends in climate research over the last 3 years?

Get specific award details

Get details for NSF award 2000001

Search by investigator

Find all NSF awards for researcher Smith

API Limitations

  • Maximum 3000 results per query (NSF API limit)
  • 25 results per page by default
  • API may have scheduled downtime (weekends: Friday 10PM–Sunday 12PM)
  • No authentication required

NSF Award Search Parameters

The NSF API supports numerous search parameters:

  • keyword - Search in titles and abstracts
  • piName - Principal investigator name
  • agency - NSF directorate code (CSE, BIO, ENG, etc.)
  • awardeeOrganization - Institution name
  • awardeeStateCode - Two-letter state code
  • startDateStart/End - Award start date range (MM/DD/YYYY)
  • expDateStart/End - Award expiration date range
  • fundProgramName - Funding program name
  • And many more...

Development

The server is built using:

  • Python 3.11+
  • MCP SDK
  • NSF Awards API v1

License

MIT

Related