Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATABENTO_API_KEY | Yes | Databento API key (required) | |
| DATABENTO_DATA_DIR | No | Restrict file operations to directory | Current directory |
| DATABENTO_LOG_LEVEL | No | Logging level (DEBUG, INFO, WARNING, ERROR) | INFO |
| DATABENTO_METRICS_ENABLED | No | Enable metrics collection | true |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| health_check | Check the health and connectivity of the Databento API. Use this to diagnose connection issues or verify the server is working properly. |
| get_historical_data | Retrieve historical market data for symbols from Databento. Examples:
Tips:
|
| get_symbol_metadata | Get metadata for symbols including symbology mappings and instrument definitions |
| search_instruments | Search for instruments in a dataset |
| list_datasets | List all available datasets from Databento |
| clear_cache | Clear the API response cache |
| get_cost | Estimate the cost of a historical data query before executing it |
| get_live_data | Subscribe to real-time market data for a limited duration |
| resolve_symbols | Resolve symbols between different symbology types |
| submit_batch_job | Submit a batch data download job for large historical datasets |
| list_batch_jobs | List all batch jobs with their current status |
| get_batch_job_files | Get download information for a completed batch job |
| get_session_info | Identify the current trading session based on time |
| list_publishers | List data publishers with their details |
| list_fields | List fields available for a specific schema |
| get_dataset_range | Get the available date range for a dataset |
| read_dbn_file | Read and parse a DBN file, returning the records as structured data |
| get_dbn_metadata | Get only the metadata from a DBN file without reading all records |
| write_dbn_file | Write historical data query results directly to a DBN file |
| convert_dbn_to_parquet | Convert a DBN file to Parquet format |
| export_to_parquet | Query historical data and export directly to Parquet format |
| read_parquet_file | Read a Parquet file and return the data |
| get_metrics | Get server performance metrics and usage statistics. Returns:
Example: get_metrics(reset=false) to view current stats |
| get_account_status | Get comprehensive server status and account information. Returns:
Example: get_account_status() for a full server overview |
| quick_analysis | One-call comprehensive analysis of a symbol. Combines: metadata + cost estimate + sample data + trading session info + data quality check. Example:
Returns:
|
| analyze_data_quality | Analyze data quality and detect issues in market data. Detects:
Returns:
Example:
|
| list_schemas | List all available data schemas from Databento. Returns:
Example: list_schemas() |
| list_unit_prices | Get current pricing information per dataset/schema combination. Parameters:
Returns:
Example: list_unit_prices(dataset="GLBX.MDP3") |
| cancel_batch_job | Cancel a pending or processing batch job. Parameters:
Returns:
Example: cancel_batch_job(job_id="JOB-12345") |
| download_batch_files | Download completed batch job files to a local directory. Parameters:
Returns:
Example: download_batch_files(job_id="JOB-12345", output_dir="/data/downloads") |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| market-data-workflow | Step-by-step guide for retrieving market data from Databento |
| cost-aware-query | How to estimate costs before running expensive queries |
| troubleshooting | Diagnose and resolve common issues with the Databento MCP server |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Databento Schema Reference | Documentation of available data schemas |
| Databento Dataset Reference | Common datasets and their descriptions |
| Error Code Reference | Complete list of error codes and their meanings |