{"openapi":"3.0.3","info":{"title":"Gnist Context — Electric Vehicle Data","description":"Electric vehicle database — range, battery, charging speed, performance for current EV models.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/ev-data/`\n- **Toolkit page:** `/toolkits/ev-data`\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/ev-data/get_ev":{"post":{"tags":["Automotive"],"summary":"get_ev","description":"Get detailed specifications for an electric vehicle.\n\nReturns range, battery capacity, charging specs, performance, and pricing.","operationId":"ev_data_get_ev","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":{"ev_id":{"description":"EV ID slug (e.g. tesla-model3-2024, bmw-i4-2024).","type":"string"}},"required":["ev_id"],"type":"object"}}}}}},"/rest/ev-data/search_evs":{"post":{"tags":["Automotive"],"summary":"search_evs","description":"Search the electric vehicle database.","operationId":"ev_data_search_evs","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 by make, model, or features.","type":"string"},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/ev-data/list_evs_by_make":{"post":{"tags":["Automotive"],"summary":"list_evs_by_make","description":"List electric vehicles by manufacturer.","operationId":"ev_data_list_evs_by_make","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":{"make":{"description":"Manufacturer (e.g. Tesla, BMW, Hyundai).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["make"],"type":"object"}}}}}},"/rest/ev-data/list_evs_by_segment":{"post":{"tags":["Automotive"],"summary":"list_evs_by_segment","description":"List electric vehicles by market segment.","operationId":"ev_data_list_evs_by_segment","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":{"segment":{"description":"Market segment (Economy, Mid-range, Premium, Luxury, Performance).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["segment"],"type":"object"}}}}}},"/rest/ev-data/list_evs_by_range":{"post":{"tags":["Automotive"],"summary":"list_evs_by_range","description":"List EVs by range, sorted from highest to lowest.","operationId":"ev_data_list_evs_by_range","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":{"min_range_km":{"default":0,"type":"integer"},"limit":{"default":20,"type":"integer"}},"type":"object"}}}}}},"/rest/ev-data/get_ev_makes":{"post":{"tags":["Automotive"],"summary":"get_ev_makes","description":"List all EV manufacturers in the database.","operationId":"ev_data_get_ev_makes","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/ev-data/get_ev_segments":{"post":{"tags":["Automotive"],"summary":"get_ev_segments","description":"List all market segments in the database.","operationId":"ev_data_get_ev_segments","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/ev-data/report_feedback":{"post":{"tags":["Automotive"],"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":"ev_data_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":"Automotive","description":"Data sources: Automotive"}],"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."}}}}