{"openapi":"3.0.3","info":{"title":"Gnist Context — NSF Awards","description":"Search NSF research awards and grants — keyword search, PI lookup, institution filtering. Covers all NSF-funded research across science, engineering, and education.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nsf-awards/`\n- **Toolkit page:** `/toolkits/nsf-awards`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/nsf-awards/search_awards":{"post":{"tags":["Science"],"summary":"search_awards","description":"Search NSF research awards and grants by keyword.\n\nCovers all NSF-funded research across science, engineering, and education.\nIncludes award details, principal investigators, institutions, and funding amounts.\n\nReturns:\n    List of matching awards with title, PI, institution, funding amount, and abstract excerpt.\n    Use award id with get_award for full details.","operationId":"nsf_awards_search_awards","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"keyword":{"description":"Search term for NSF awards (e.g. \"machine learning\", \"climate change\", \"quantum computing\").","type":"string"},"awardee_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Institution name to filter by (e.g. \"MIT\", \"Stanford University\")."},"start_date_start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter awards starting after this date (MM/DD/YYYY format)."},"start_date_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter awards starting before this date (MM/DD/YYYY format)."},"limit":{"default":25,"description":"Number of results (1–25, default 25).","type":"integer"}},"required":["keyword"],"type":"object"}}}}}},"/rest/nsf-awards/get_award":{"post":{"tags":["Science"],"summary":"get_award","description":"Get detailed information about a specific NSF award.\n\nReturns the full award record including abstract, PI, institution, funding,\nand program information. Use the id from search_awards results.\n\nReturns:\n    Award details with abstract, PI, institution, funding amount, dates,\n    and program info. Returns found=false if award not found.","operationId":"nsf_awards_get_award","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"award_id":{"description":"NSF award ID (e.g. \"2548201\"). Found in search_awards results.","type":"string"}},"required":["award_id"],"type":"object"}}}}}},"/rest/nsf-awards/search_by_pi":{"post":{"tags":["Science"],"summary":"search_by_pi","description":"Search NSF awards by principal investigator name.\n\nFind all NSF grants awarded to a specific researcher. Optionally filter\nby keyword to narrow to a research area.\n\nReturns:\n    List of awards for the specified PI with title, institution, funding, and dates.","operationId":"nsf_awards_search_by_pi","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"pi_last_name":{"description":"Principal investigator's last name.","type":"string"},"pi_first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Principal investigator's first name (optional, narrows results)."},"keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional keyword to further filter results."},"limit":{"default":25,"description":"Number of results (1–25, default 25).","type":"integer"}},"required":["pi_last_name"],"type":"object"}}}}}},"/rest/nsf-awards/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"nsf_awards_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}