{"openapi":"3.0.3","info":{"title":"Gnist Context — Open Data (Government Portals)","description":"Search 460K+ government datasets across US (data.gov), UK (data.gov.uk), and Canada (open.canada.ca) open data portals — find datasets by topic, organization, or keyword.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/opendata/`\n- **Toolkit page:** `/toolkits/opendata`\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/opendata/search_datasets":{"post":{"tags":["Government"],"summary":"search_datasets","description":"Search government open data datasets across US (data.gov), UK (data.gov.uk), or Canada (open.canada.ca).\n\nCovers 460K+ datasets published by government agencies — CSV, JSON, GeoJSON, and API\nendpoints for climate, transportation, health, economics, geospatial, and more. All free,\nno API key required. Each result includes download links, formats, and organization info.\n\nArgs:\n    query: Keyword or topic to search for.\n    portal: Which country portal to search.\n    limit: Number of results (1-50, default 20).\n    offset: Pagination offset.\n\nReturns:\n    List of matching datasets with title, description, organization, resources (download links),\n    tags, and license. Use get_dataset for full details on a specific result.","operationId":"opendata_search_datasets","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":{"query":{"description":"Search query for datasets (e.g. \"climate change\", \"transportation safety\", \"public health spending\").","type":"string"},"portal":{"default":"us","description":"Portal to search: 'us' (data.gov, 290K+ datasets), 'uk' (data.gov.uk, 55K+), 'ca' (open.canada.ca, 115K+). Default 'us'.","type":"string"},"limit":{"default":20,"description":"Number of results (1-50, default 20).","type":"integer"},"offset":{"default":0,"description":"Result offset for pagination (default 0).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/opendata/get_dataset":{"post":{"tags":["Government"],"summary":"get_dataset","description":"Get full details for a single government dataset by its name or ID.\n\nReturns complete metadata including all download resources (CSV, JSON, API endpoints),\ndescription, organization, tags, license, and last-modified date.\n\nArgs:\n    dataset_id: Dataset name or UUID from search results.\n    portal: Which country portal.\n\nReturns:\n    Full dataset record with resources, or found=false if not found.","operationId":"opendata_get_dataset","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":{"dataset_id":{"description":"Dataset name or ID (e.g. 'annual-enterprise-survey-2021'). Found in search_datasets results.","type":"string"},"portal":{"default":"us","description":"Portal: 'us', 'uk', or 'ca'. Default 'us'.","type":"string"}},"required":["dataset_id"],"type":"object"}}}}}},"/rest/opendata/list_organizations":{"post":{"tags":["Government"],"summary":"list_organizations","description":"List government organizations that publish open data on a portal.\n\nBrowse the publishing organizations (agencies, departments, offices) on a specific\nportal. Each entry shows the organization name, description, and number of datasets published.\n\nArgs:\n    portal: Which country portal.\n    limit: Number of results (1-50, default 20).\n\nReturns:\n    List of organizations with name, description, and dataset count.","operationId":"opendata_list_organizations","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"portal":{"default":"us","description":"Portal: 'us', 'uk', or 'ca'. Default 'us'.","type":"string"},"limit":{"default":20,"description":"Number of results (1-50, default 20).","type":"integer"}},"type":"object"}}}}}},"/rest/opendata/get_organization":{"post":{"tags":["Government"],"summary":"get_organization","description":"Get details for a specific government data-publishing organization.\n\nReturns organization metadata including description, logo, and total dataset count.\n\nArgs:\n    org_id: Organization name or UUID.\n    portal: Which country portal.\n\nReturns:\n    Organization details with dataset count, or found=false if not found.","operationId":"opendata_get_organization","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":{"org_id":{"description":"Organization name or ID (e.g. 'nasa-gov', 'department-of-energy'). Found in list_organizations results.","type":"string"},"portal":{"default":"us","description":"Portal: 'us', 'uk', or 'ca'. Default 'us'.","type":"string"}},"required":["org_id"],"type":"object"}}}}}},"/rest/opendata/report_feedback":{"post":{"tags":["Government"],"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":"opendata_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":"Government","description":"Data sources: Government"}],"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."}}}}