{"openapi":"3.0.3","info":{"title":"Gnist Context — OECD Statistics","description":"OECD economic statistics — GDP, trade, education, health, labour, and environment data across 38+ member economies.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/oecd/`\n- **Toolkit page:** `/toolkits/oecd`\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/oecd/search_datasets":{"post":{"tags":["Economics"],"summary":"search_datasets","description":"Search the OECD dataset catalog by keyword.\n\nReturns matching datasets with their full dataflow IDs needed for\nget_data, get_dataset_structure, and compare_countries calls.\nOECD covers 38+ member economies with data on GDP, trade, education,\nhealth, labor, environment, governance, and more.\n\nArgs:\n    query: Search term (e.g. \"gdp\", \"productivity\", \"education\").\n    limit: Number of results to return (1-50, default 20).\n\nReturns:\n    List of matching datasets with id, name, agency, and description.\n    Use the 'id' field as the dataflow parameter in other tools.","operationId":"oecd_search_datasets","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 term for OECD datasets (e.g. \"gdp\", \"productivity\", \"education\", \"trade\", \"labour\", \"health\").","type":"string"},"limit":{"default":20,"description":"Number of results to return (1-50, default 20).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/oecd/list_datasets":{"post":{"tags":["Economics"],"summary":"list_datasets","description":"List available OECD datasets, optionally filtered by topic.\n\nBrowse the full OECD data catalog. Use this to discover what\ndatasets exist before querying specific data.\n\nArgs:\n    topic: Optional topic filter keyword. Omit to list all datasets.\n    limit: Maximum datasets to return (1-200, default 50).\n\nReturns:\n    List of datasets with id, name, and description.","operationId":"oecd_list_datasets","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":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional topic filter (e.g. \"health\", \"labour\", \"education\", \"environment\"). Omit to list all."},"limit":{"default":50,"description":"Maximum datasets to return (1-200, default 50).","type":"integer"}},"type":"object"}}}}}},"/rest/oecd/get_dataset_structure":{"post":{"tags":["Economics"],"summary":"get_dataset_structure","description":"Get the dimension structure of an OECD dataset.\n\nShows what dimensions (filters) are available for a dataset and their\nvalid values. Use this before get_data to understand what country codes,\nindicators, frequencies, and other parameters are accepted.\n\nArgs:\n    dataflow: OECD dataflow identifier from search_datasets.\n\nReturns:\n    List of dimensions with their valid codes/values. Each dimension\n    shows its position in the SDMX key and sample values.","operationId":"oecd_get_dataset_structure","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":{"dataflow":{"description":"OECD dataflow identifier from search_datasets (e.g. \"OECD.SDD.TPS,DSD_PDB@DF_PDB_LV,1.0\").","type":"string"}},"required":["dataflow"],"type":"object"}}}}}},"/rest/oecd/get_data":{"post":{"tags":["Economics"],"summary":"get_data","description":"Fetch data from an OECD dataset.\n\nQuery any OECD dataset using an SDMX dimension key filter.\nUse get_dataset_structure first to find valid dimension values\nand their positions in the key.\n\nOECD does not support startPeriod/endPeriod filters.\nUse last_n_observations to limit the time range.\n\nArgs:\n    dataflow: OECD dataflow identifier. Use search_datasets to find IDs.\n    key_filter: SDMX dimension key with * wildcards for any position.\n    last_n_observations: Return only the last N time periods.\n    limit: Maximum observations to return (1-1000, default 200).\n\nReturns:\n    Observations with all dimension labels and values.","operationId":"oecd_get_data","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":{"dataflow":{"description":"OECD dataflow identifier (e.g. \"OECD.SDD.TPS,DSD_PDB@DF_PDB_LV,1.0\"). Use search_datasets to find IDs.","type":"string"},"key_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"SDMX dimension key (dot-separated, * for wildcard, e.g. \"A.USA.*.*.*\"). Use get_dataset_structure to find valid values."},"last_n_observations":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Return only the last N time periods (1-100)."},"limit":{"default":200,"description":"Maximum observations to return (1-1000, default 200).","type":"integer"}},"required":["dataflow"],"type":"object"}}}}}},"/rest/oecd/compare_countries":{"post":{"tags":["Economics"],"summary":"compare_countries","description":"Compare data across countries for a given OECD dataset.\n\nFetches the same indicator for multiple countries side by side.\nUseful for cross-country analysis of GDP, productivity, education,\nhealth, and other OECD statistics.\n\nArgs:\n    dataflow: OECD dataflow identifier.\n    country_codes: ISO alpha-3 country codes to compare. Maximum 20.\n    last_n_observations: Return last N time periods (1-100, default 5).\n\nReturns:\n    Data grouped by country for easy comparison.","operationId":"oecd_compare_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":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"dataflow":{"description":"OECD dataflow identifier (e.g. \"OECD.SDD.TPS,DSD_PDB@DF_PDB_LV,1.0\").","type":"string"},"country_codes":{"description":"ISO alpha-3 country codes to compare (e.g. [\"USA\", \"DEU\", \"JPN\", \"NOR\"]). Maximum 20.","items":{"type":"string"},"type":"array"},"last_n_observations":{"default":5,"description":"Return last N time periods per country (1-100, default 5).","type":"integer"}},"required":["dataflow","country_codes"],"type":"object"}}}}}},"/rest/oecd/report_feedback":{"post":{"tags":["Economics"],"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":"oecd_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":"Economics","description":"Data sources: Economics"}],"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."}}}}