{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dmq7vj8s72xg","handle":"timescaledb-mcp","url":"https://wellknown.network/agents/timescaledb-mcp","links":{"self":"https://wellknown.network/agents/timescaledb-mcp/record.json","html":"https://wellknown.network/agents/timescaledb-mcp","markdown":"https://wellknown.network/agents/timescaledb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/timescaledb-mcp","status":"https://wellknown.network/api/v1/agents/timescaledb-mcp/status","claim":"https://wellknown.network/agents/timescaledb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/timescaledb-mcp/claim.json","badge":"https://wellknown.network/agents/timescaledb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:timescaledb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"timescaledb-mcp","summary":"A Model Context Protocol (MCP) server for TimescaleDB","description":"# TimescaleDB MCP Server\n\nA Python-based Model Context Protocol (MCP) server for TimescaleDB that enables AI assistants to interact with your time-series database.\n\n## Features\n\n- **Async Database Operations**: Built on `asyncpg` for high-performance async database access\n- **Connection Pooling**: Efficient connection pool management with configurable pool sizes\n- **MCP Resources**: Schema introspection via MCP resources for tables and hypertables\n- **MCP Prompts**: Pre-built prompts for common operations (query time-series, analyze hypertables, explore schema)\n- **SQL Injection Prevention**: Parameterized queries throughout for security\n- **Comprehensive Error Handling**: Custom exceptions with clear error messages\n- **Type Safety**: Full type hints and TypedDict support\n- **6 MCP Tools**: Execute queries, list/describe tables and hypertables, query time-series data\n- **Structured Logging**: Comprehensive logging for debugging and monitoring\n\n## Installation\n\n### From PyPI\n\n```bash\npip install timescaledb-mcp\n```\n\nOr using `uv` (faster):\n\n```bash\nuv pip install timescaledb-mcp\n```\n\nThe package is available on [PyPI](https://pypi.org/project/timescaledb-mcp/).\n\n### From Source\n\n1. Clone this repository:\n```bash\ngit clone https://github.com/brunoprela/timescaledb-mcp.git\ncd timescaledb-mcp\n```\n\n2. Install using pip:\n```bash\npip install -e .\n```\n\nOr using `uv`:\n```bash\nuv pip install -e .\n```\n\nFor development with additional tools:\n```bash\npip install -e \".[dev]\"\n# or\nuv pip install -e \".[dev]\"\n```\n\n## Configuration\n\nConfiguration is managed via environment variables with the `TIMESCALEDB_` prefix.\n\n### Required Settings\n\n```env\nTIMESCALEDB_HOST=localhost\nTIMESCALEDB_PORT=5432\nTIMESCALEDB_DATABASE=your_database\nTIMESCALEDB_USER=your_user\nTIMESCALEDB_PASSWORD=your_password\n```\n\n### Optional Settings\n\n```env\nTIMESCALEDB_MIN_POOL_SIZE=1        # Minimum connection pool size (default: 1)\nTIMESCALEDB_MAX_POOL_SIZE=10       # Maximum connection pool size (default: 10)\nTIME…","publisher":null,"homepage":"https://github.com/brunoprela/timescaledb-mcp#readme","repository":"https://github.com/brunoprela/timescaledb-mcp#readme","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","postgresql","timescaledb","timeseries"],"pricing":null,"endpoints":[{"url":"pypi:timescaledb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["ai","data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"timescaledb-mcp","registry":"pypi","observedAt":"2026-09-10T14:24:24.413Z","publishedAt":"2025-11-21T03:21:26.870965Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"timescaledb-mcp","url":"https://pypi.org/project/timescaledb-mcp/","firstSeenAt":"2026-09-10T14:22:34.007Z","fetchedAt":"2026-09-10T14:22:34.007Z","normalizedAt":"2026-09-10T14:22:34.007Z"}]},"firstSeenAt":"2026-09-10T14:22:34.007Z","updatedAt":"2026-09-10T14:24:24.413Z"}