TimeBase MCP
TimeBase MCP is a Model Context Protocol server that enables coding agents to interact with the TimeBase time-series database. It allows users to list streams, read schemas and symbols, preview messages, run QQL queries, and inspect server status and activity. The server supports both local execution via stdio and remote deployment as a shared HTTP service for multiple users.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- List available data streams
- Read schemas and symbols
- Run QQL queries on time-series data
- Inspect server status and activity
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
timebase-mcp 0.2.7
{
"version": "0.2.7",
"transport": "stdio",
"identifier": "timebase-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"runtimeArguments": [
{
"name": "--from",
"type": "named",
"value": "timebase-mcp[all]"
}
],
"environmentVariables": [
{
"name": "TIMEBASE_URL",
"default": "dxtick://localhost:8011",
"description": "TimeBase native connection URL.",
"placeholder": "dxtick://localhost:8011"
},
{
"name": "TIMEBASE_SERVERS",
"format": "string",
"description": "Multi-server config as a JSON array string or path to a JSON file."
},
{
"name": "TIMEBASE_USERNAME",
"format": "string",
"description": "Username for basic auth or oauth2_client_credentials."
},
{
"name": "TIMEBASE_PASSWORD",
"format": "string",
"description": "Password for basic auth."
},
{
"name": "TIMEBASE_OAUTH2_TOKEN_URL",
"format": "string",
"description": "OAuth2 token endpoint for service-account client credentials."
},
{
"name": "TIMEBASE_OAUTH2_CLIENT_ID",
"format": "string",
"description": "OAuth2 client ID for service-account or interactive login."
},
{
"name": "TIMEBASE_OAUTH2_CLIENT_SECRET",
"format": "string",
"description": "OAuth2 client secret for service-account auth."
},
{
"name": "TIMEBASE_OAUTH2_SCOPE",
"format": "string",
"description": "OAuth2 scope(s) for service-account or interactive login."
},
{
"name": "MCP_LOG_LEVEL",
"choices": [
"DEBUG",
"INFO",
"WARNING",
"ERROR",
"CRITICAL"
],
"default": "INFO",
"description": "Log level: DEBUG, INFO, WARNING, ERROR, or CRITICAL."
},
{
"name": "TIMEBASE_AUTH_MODE",
"choices": [
"auto",
"none",
"basic",
"oauth2_client_credentials",
"interactive"
],
"default": "auto",
"description": "Outbound auth: auto, none, basic, oauth2_client_credentials, interactive."
},
{
"name": "MCP_HOST",
"default": "127.0.0.1",
"description": "Loopback host for interactive OAuth redirect in stdio mode."
},
{
"name": "MCP_PORT",
"format": "number",
"default": "8000",
"description": "Loopback port for interactive OAuth redirect in stdio mode."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"timebase-mcp": {
"command": "uvx",
"args": [
"timebase-mcp==0.2.7"
],
"env": {
"TIMEBASE_URL": "<YOUR_TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<YOUR_TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<YOUR_TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<YOUR_TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<YOUR_TIMEBASE_OAUTH2_TOKEN_URL>",
"TIMEBASE_OAUTH2_CLIENT_ID": "<YOUR_TIMEBASE_OAUTH2_CLIENT_ID>",
"TIMEBASE_OAUTH2_CLIENT_SECRET": "<YOUR_TIMEBASE_OAUTH2_CLIENT_SECRET>",
"TIMEBASE_OAUTH2_SCOPE": "<YOUR_TIMEBASE_OAUTH2_SCOPE>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"TIMEBASE_AUTH_MODE": "<YOUR_TIMEBASE_AUTH_MODE>",
"MCP_HOST": "<YOUR_MCP_HOST>",
"MCP_PORT": "<YOUR_MCP_PORT>"
}
}
}
}Cline
{
"mcpServers": {
"timebase-mcp": {
"command": "uvx",
"args": [
"timebase-mcp==0.2.7"
],
"env": {
"TIMEBASE_URL": "<YOUR_TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<YOUR_TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<YOUR_TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<YOUR_TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<YOUR_TIMEBASE_OAUTH2_TOKEN_URL>",
"TIMEBASE_OAUTH2_CLIENT_ID": "<YOUR_TIMEBASE_OAUTH2_CLIENT_ID>",
"TIMEBASE_OAUTH2_CLIENT_SECRET": "<YOUR_TIMEBASE_OAUTH2_CLIENT_SECRET>",
"TIMEBASE_OAUTH2_SCOPE": "<YOUR_TIMEBASE_OAUTH2_SCOPE>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"TIMEBASE_AUTH_MODE": "<YOUR_TIMEBASE_AUTH_MODE>",
"MCP_HOST": "<YOUR_MCP_HOST>",
"MCP_PORT": "<YOUR_MCP_PORT>"
}
}
}
}VS Code
{
"servers": {
"timebase-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"timebase-mcp==0.2.7"
],
"env": {
"TIMEBASE_URL": "<YOUR_TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<YOUR_TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<YOUR_TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<YOUR_TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<YOUR_TIMEBASE_OAUTH2_TOKEN_URL>",
"TIMEBASE_OAUTH2_CLIENT_ID": "<YOUR_TIMEBASE_OAUTH2_CLIENT_ID>",
"TIMEBASE_OAUTH2_CLIENT_SECRET": "<YOUR_TIMEBASE_OAUTH2_CLIENT_SECRET>",
"TIMEBASE_OAUTH2_SCOPE": "<YOUR_TIMEBASE_OAUTH2_SCOPE>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"TIMEBASE_AUTH_MODE": "<YOUR_TIMEBASE_AUTH_MODE>",
"MCP_HOST": "<YOUR_MCP_HOST>",
"MCP_PORT": "<YOUR_MCP_PORT>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"timebase-mcp": {
"command": "uvx",
"args": [
"timebase-mcp==0.2.7"
],
"env": {
"TIMEBASE_URL": "<YOUR_TIMEBASE_URL>",
"TIMEBASE_SERVERS": "<YOUR_TIMEBASE_SERVERS>",
"TIMEBASE_USERNAME": "<YOUR_TIMEBASE_USERNAME>",
"TIMEBASE_PASSWORD": "<YOUR_TIMEBASE_PASSWORD>",
"TIMEBASE_OAUTH2_TOKEN_URL": "<YOUR_TIMEBASE_OAUTH2_TOKEN_URL>",
"TIMEBASE_OAUTH2_CLIENT_ID": "<YOUR_TIMEBASE_OAUTH2_CLIENT_ID>",
"TIMEBASE_OAUTH2_CLIENT_SECRET": "<YOUR_TIMEBASE_OAUTH2_CLIENT_SECRET>",
"TIMEBASE_OAUTH2_SCOPE": "<YOUR_TIMEBASE_OAUTH2_SCOPE>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"TIMEBASE_AUTH_MODE": "<YOUR_TIMEBASE_AUTH_MODE>",
"MCP_HOST": "<YOUR_MCP_HOST>",
"MCP_PORT": "<YOUR_MCP_PORT>"
}
}
}
}Let your agent find its tools
Find servers like TimeBase MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.