{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_asqdwh39yva4","handle":"sql-server-mcp","url":"https://wellknown.network/agents/sql-server-mcp","links":{"self":"https://wellknown.network/agents/sql-server-mcp/record.json","html":"https://wellknown.network/agents/sql-server-mcp","markdown":"https://wellknown.network/agents/sql-server-mcp/record.md","api":"https://wellknown.network/api/v1/agents/sql-server-mcp","status":"https://wellknown.network/api/v1/agents/sql-server-mcp/status","claim":"https://wellknown.network/agents/sql-server-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/sql-server-mcp/claim.json","badge":"https://wellknown.network/agents/sql-server-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:sql-server-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"sql-server-mcp","summary":"Local, single-user MCP server for read-only SQL Server / MS Fabric queries - one process per tenant","description":"# sql-server-mcp\n\nA local MCP server for read-only SQL Server / MS Fabric queries. Runs as a\nsingle-user process over stdio, authenticated as *you* (delegated Entra ID\nidentity, not a service principal) — **one server process per\ntenant**. \n\n## Prerequisites\n\n- Python 3.14+ and [uv](https://docs.astral.sh/uv/)\n- Either the [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) logged in to the target tenant (`az login --tenant <tenant-id>`), or just a browser available — the server falls back to an interactive browser login if there's no CLI session\n- An Entra ID account in the target tenant with read access to the target database (e.g. `db_datareader`)\n\n## Configuration\n\nEach tenant gets its own set of environment variables:\n\n| Variable | Required | Description |\n|---|---|---|\n| `MCP_SQL_SERVER_NAME` | yes | SQL Server / Fabric SQL endpoint hostname, e.g. `xyz-xyz.datawarehouse.fabric.microsoft.com` |\n| `MCP_SQL_DATABASE_NAME` | yes | Default database to connect to |\n| `MCP_AZURE_TENANT_ID` | yes | The Entra ID tenant ID — pins auth to this directory even if your machine has other `az login` sessions active |\n| `MCP_MAX_ROWS` | no | Max rows returned per tool call (default: 25) |\n\n## Running it\n\nThe server is a `uvx`-runnable console script (`sql-server-mcp`), no\nmanual install step needed - `uvx` builds an isolated environment for it\non first run and reuses it afterwards:\n\n```bash\nuvx sql-server-mcp\n```\n\nTo run from a local checkout instead (e.g. during development), point\n`--from` at the path:\n\n```bash\nuvx --from /path/to/sql-server-mcp sql-server-mcp\n```\n\nOn startup it acquires a token (via `az login` if available, otherwise an\ninteractive browser prompt) and runs over stdio. Database connectivity uses\n[`mssql-python`](https://github.com/microsoft/mssql-python), which bundles\nits own driver — no separate ODBC driver install is required.\n\n### Example MCP client config\n\nOne block per tenant:\n\n```json\n{\n  \"mcpServers\": {\n    \"tenant-a-sql\": {\n      \"…","publisher":null,"homepage":null,"repository":"https://github.com/ahaugerud/sql-server-mcp","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["azure","fabric","mcp","model-context-protocol","sql-server"],"pricing":null,"endpoints":[{"url":"pypi:sql-server-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.779,"provenance":"derived"}],"categories":["data","infra","security"],"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":"sql-server-mcp","registry":"pypi","observedAt":"2026-09-10T13:21:27.766Z","publishedAt":"2026-09-07T07:15:42.139052Z","latestVersion":"0.3.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"sql-server-mcp","url":"https://pypi.org/project/sql-server-mcp/","firstSeenAt":"2026-09-10T13:19:21.513Z","fetchedAt":"2026-09-10T13:19:21.513Z","normalizedAt":"2026-09-10T13:19:21.513Z"}]},"firstSeenAt":"2026-09-10T13:19:21.513Z","updatedAt":"2026-09-10T13:21:27.766Z"}