{"openapi":"3.0.3","info":{"title":"Gnist Context — S&P 500 Companies","description":"S&P 500 companies — ticker, sector, sub-industry, headquarters, and CIK numbers.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/sp500/`\n- **Toolkit page:** `/toolkits/sp500`\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/sp500/get_sp500_company":{"post":{"tags":["Finance"],"summary":"get_sp500_company","description":"Get detailed information about an S&P 500 company by ticker symbol.\n\nReturns company name, GICS sector, sub-industry, headquarters, founding year, and SEC CIK number.","operationId":"sp500_get_sp500_company","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":{"ticker":{"description":"Stock ticker symbol (e.g. AAPL, MSFT, GOOGL).","type":"string"}},"required":["ticker"],"type":"object"}}}}}},"/rest/sp500/search_sp500_companies":{"post":{"tags":["Finance"],"summary":"search_sp500_companies","description":"Search the S&P 500 companies database.","operationId":"sp500_search_sp500_companies","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 company name or ticker symbol.","type":"string"},"limit":{"default":20,"description":"Maximum results to return.","maximum":100,"minimum":1,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/sp500/list_sp500_by_sector":{"post":{"tags":["Finance"],"summary":"list_sp500_by_sector","description":"List S&P 500 companies by GICS sector.","operationId":"sp500_list_sp500_by_sector","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":{"sector":{"description":"GICS sector (e.g. Information Technology, Health Care, Financials).","type":"string"},"limit":{"default":50,"description":"Maximum results to return.","maximum":100,"minimum":1,"type":"integer"}},"required":["sector"],"type":"object"}}}}}},"/rest/sp500/report_feedback":{"post":{"tags":["Finance"],"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":"sp500_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":"Finance","description":"Data sources: Finance"}],"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."}}}}