{"openapi":"3.0.3","info":{"title":"Gnist Context — US County Data","description":"US county-level data — population, area, FIPS codes, and county seats for ~200 US counties.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/us-county/`\n- **Toolkit page:** `/toolkits/us-county`\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/us-county/get_county":{"post":{"tags":["Geography"],"summary":"get_county","description":"Get detailed information about a US county by its 5-digit FIPS code.\n\nArgs:\n    fips: 5-digit FIPS code (e.g. \"06037\" for Los Angeles County, CA).\n\nReturns:\n    Dictionary with county details including population, area, and county seat.","operationId":"us_county_get_county","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":{"fips":{"type":"string"}},"required":["fips"],"type":"object"}}}}}},"/rest/us-county/search_counties":{"post":{"tags":["Geography"],"summary":"search_counties","description":"Search US counties by name (case-insensitive partial match).\n\nArgs:\n    query: Search string to match against county names.\n    limit: Maximum number of results to return (default 20).\n\nReturns:\n    Dictionary with count and list of matching counties.","operationId":"us_county_search_counties","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":{"type":"string"},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/us-county/list_counties_by_state":{"post":{"tags":["Geography"],"summary":"list_counties_by_state","description":"List US counties in a given state, sorted by population descending.\n\nArgs:\n    state_code: Two-letter US state code (e.g. \"CA\", \"TX\", \"NY\").\n    limit: Maximum number of results to return (default 50).\n\nReturns:\n    Dictionary with state, count, and list of counties.","operationId":"us_county_list_counties_by_state","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":{"state_code":{"type":"string"},"limit":{"default":50,"type":"integer"}},"required":["state_code"],"type":"object"}}}}}},"/rest/us-county/get_states":{"post":{"tags":["Geography"],"summary":"get_states","description":"List all US states in the dataset with their county counts.\n\nReturns:\n    Dictionary with total state count and list of states with county counts.","operationId":"us_county_get_states","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":[]}]}},"/rest/us-county/report_feedback":{"post":{"tags":["Geography"],"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":"us_county_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":"Geography","description":"Data sources: Geography"}],"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."}}}}