{"openapi":"3.0.3","info":{"title":"Gnist Context — Postal Codes","description":"Postal/ZIP code lookup — city, state, coordinates for 70+ countries.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/postal-codes/`\n- **Toolkit page:** `/toolkits/postal-codes`\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/postal-codes/lookup_postal_code":{"post":{"tags":["Reference"],"summary":"lookup_postal_code","description":"Look up location details for a postal/ZIP code — city, state, country, and coordinates.\n\nSupports 70+ countries including US, UK, Norway, Germany, France, Japan, and more.","operationId":"postal_codes_lookup_postal_code","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":{"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'US', 'NO', 'DE').","type":"string"},"postal_code":{"description":"Postal or ZIP code to look up (e.g. '90210', '0150').","type":"string"}},"required":["country_code","postal_code"],"type":"object"}}}}}},"/rest/postal-codes/search_by_place":{"post":{"tags":["Reference"],"summary":"search_by_place","description":"Find postal codes for a city within a country and state.\n\nUseful for reverse lookup — find postal codes when you know the place name.","operationId":"postal_codes_search_by_place","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":{"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. 'US', 'DE').","type":"string"},"state":{"description":"State or province name (e.g. 'California', 'Bayern').","type":"string"},"city":{"description":"City or place name (e.g. 'Los Angeles', 'München').","type":"string"}},"required":["country_code","state","city"],"type":"object"}}}}}},"/rest/postal-codes/list_supported_countries":{"post":{"tags":["Reference"],"summary":"list_supported_countries","description":"List all countries supported for postal code lookup.\n\nReturns ISO country codes and names for all 70+ supported countries.","operationId":"postal_codes_list_supported_countries","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/postal-codes/report_feedback":{"post":{"tags":["Reference"],"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":"postal_codes_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":"Reference","description":"Data sources: Reference"}],"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."}}}}