{"openapi":"3.0.3","info":{"title":"Gnist Context — Phone Number Validation","description":"Phone number validation and parsing — country detection, number type, formatting.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/phone-validation/`\n- **Toolkit page:** `/toolkits/phone-validation`\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/phone-validation/validate_phone_number":{"post":{"tags":["Utilities"],"summary":"validate_phone_number","description":"Validate and parse a phone number.\n\nReturns country, number type (mobile/landline/toll_free/premium), and formatted versions (E.164, international, national).","operationId":"phone_validation_validate_phone_number","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":{"number":{"description":"Phone number to validate (E.164, international, or national format, e.g. +14155551234, 00441234567890).","type":"string"}},"required":["number"],"type":"object"}}}}}},"/rest/phone-validation/format_phone_number":{"post":{"tags":["Utilities"],"summary":"format_phone_number","description":"Format a phone number in the specified style.\n\nReturns the number formatted as E.164 (+1234567890), international (+1 234 567 890), or national (0234 567 890).","operationId":"phone_validation_format_phone_number","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":{"number":{"description":"Phone number to format.","type":"string"},"fmt":{"default":"e164","description":"Output format: e164, international, or national.","type":"string"}},"required":["number"],"type":"object"}}}}}},"/rest/phone-validation/list_calling_codes":{"post":{"tags":["Utilities"],"summary":"list_calling_codes","description":"List all known country calling codes with metadata.\n\nReturns calling code, country name, trunk prefix, number length ranges, and example numbers for ~50 countries.","operationId":"phone_validation_list_calling_codes","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/phone-validation/get_calling_code":{"post":{"tags":["Utilities"],"summary":"get_calling_code","description":"Get calling code details for a specific country.\n\nReturns calling code, trunk prefix, number length, example numbers, and known prefix patterns for mobile/landline.","operationId":"phone_validation_get_calling_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, GB, NO, DE).","type":"string"}},"required":["country_code"],"type":"object"}}}}}},"/rest/phone-validation/report_feedback":{"post":{"tags":["Utilities"],"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":"phone_validation_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":"Utilities","description":"Data sources: Utilities"}],"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."}}}}