{"openapi":"3.0.3","info":{"title":"Gnist Context — BIS (Bank for International Settlements)","description":"BIS financial statistics — credit/debt, derivatives, banking, property prices, exchange rates, and central bank policy rates.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/bis/`\n- **Toolkit page:** `/toolkits/bis`\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/bis/search_datasets":{"post":{"tags":["Finance"],"summary":"search_datasets","description":"Search the BIS dataset catalog by keyword.\n\nReturns matching datasets with their dataflow IDs needed for\nget_data, get_dataset_structure, and compare_countries calls.\nBIS covers credit/debt, derivatives, banking, property prices,\nexchange rates, and other financial statistics from central banks worldwide.\n\nArgs:\n    query: Search term (e.g. \"credit\", \"exchange rates\", \"property prices\").\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":"bis_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 BIS datasets (e.g. \"credit\", \"exchange rates\", \"property prices\", \"banking\", \"derivatives\").","type":"string"},"limit":{"default":20,"description":"Number of results to return (1-50, default 20).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/bis/list_datasets":{"post":{"tags":["Finance"],"summary":"list_datasets","description":"List available BIS datasets, optionally filtered by topic.\n\nBrowse the full BIS 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-100, default 50).\n\nReturns:\n    List of datasets with id, name, and description.","operationId":"bis_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. \"banking\", \"credit\", \"exchange\", \"derivatives\"). Omit to list all."},"limit":{"default":50,"description":"Maximum datasets to return (1-100, default 50).","type":"integer"}},"type":"object"}}}}}},"/rest/bis/get_dataset_structure":{"post":{"tags":["Finance"],"summary":"get_dataset_structure","description":"Get the dimension structure of a BIS 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,\nfrequencies, and other parameters are accepted.\n\nArgs:\n    dataflow: BIS 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":"bis_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":"BIS dataflow identifier from search_datasets (e.g. \"WS_CBPOL\", \"WS_SPP\", \"WS_CREDIT_GAP\").","type":"string"}},"required":["dataflow"],"type":"object"}}}}}},"/rest/bis/get_data":{"post":{"tags":["Finance"],"summary":"get_data","description":"Fetch data from a BIS dataset.\n\nQuery any BIS dataset by country and time period. Covers central bank\npolicy rates, credit statistics, property prices, exchange rates,\nderivatives, and banking statistics worldwide.\n\nArgs:\n    dataflow: BIS dataflow identifier. Use search_datasets to find IDs.\n    countries: ISO alpha-2 country codes. Omit for all countries.\n    start_period: Start period filter (e.g. \"2015\").\n    end_period: End period filter (e.g. \"2023\").\n    dimension_filter: Advanced SDMX dimension key. Overrides countries.\n    limit: Maximum observations to return (1-1000, default 200).\n\nReturns:\n    Observations with all dimension labels and values.","operationId":"bis_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":"BIS dataflow identifier (e.g. \"WS_CBPOL\", \"WS_SPP\"). Use search_datasets to find IDs.","type":"string"},"countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"ISO alpha-2 country codes (e.g. [\"US\", \"DE\", \"NO\"]). Omit for all countries."},"start_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start period (e.g. \"2015\", \"2020-Q1\", \"2020-01\")."},"end_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End period (e.g. \"2023\", \"2023-Q4\", \"2023-12\")."},"dimension_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Advanced: SDMX dimension key filter (dot-separated, e.g. \"M.US+DE\"). Overrides countries param. Use get_dataset_structure to find valid dimension values."},"limit":{"default":200,"description":"Maximum observations to return (1-1000, default 200).","type":"integer"}},"required":["dataflow"],"type":"object"}}}}}},"/rest/bis/compare_countries":{"post":{"tags":["Finance"],"summary":"compare_countries","description":"Compare data across countries for a given BIS dataset.\n\nFetches the same indicator for multiple countries side by side.\nUseful for cross-country analysis of policy rates, credit growth,\nproperty prices, and other BIS financial statistics.\n\nArgs:\n    dataflow: BIS dataflow identifier.\n    country_codes: ISO alpha-2 country codes to compare. Maximum 20.\n    start_period: Start period. Omit for most recent data.\n    end_period: End period. Omit for most recent data.\n\nReturns:\n    Data grouped by country for easy comparison.","operationId":"bis_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":"BIS dataflow identifier (e.g. \"WS_CBPOL\", \"WS_SPP\").","type":"string"},"country_codes":{"description":"ISO alpha-2 country codes to compare (e.g. [\"US\", \"DE\", \"JP\", \"NO\"]). Maximum 20.","items":{"type":"string"},"type":"array"},"start_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start period (e.g. \"2020\"). Omit for most recent data."},"end_period":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End period (e.g. \"2023\"). Omit for most recent data."}},"required":["dataflow","country_codes"],"type":"object"}}}}}},"/rest/bis/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":"bis_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."}}}}