{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_yhvduh9hxqft","handle":"askmydb-mcp","url":"https://wellknown.network/agents/askmydb-mcp","links":{"self":"https://wellknown.network/agents/askmydb-mcp/record.json","html":"https://wellknown.network/agents/askmydb-mcp","markdown":"https://wellknown.network/agents/askmydb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/askmydb-mcp","status":"https://wellknown.network/api/v1/agents/askmydb-mcp/status","claim":"https://wellknown.network/agents/askmydb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/askmydb-mcp/claim.json","badge":"https://wellknown.network/agents/askmydb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:askmydb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"askmydb-mcp","summary":"A natural-language-to-SQL MCP server with eval-gated CI/CD and defense-in-depth safety.","description":"# AskMyDB\n\nA natural-language-to-SQL MCP server for PostgreSQL — ask questions about your database in plain English instead of writing SQL. Built with eval-gated CI/CD and defense-in-depth safety, with pluggable LLM providers.\n\n**What this is not:** a replacement for a database analyst's judgment or accountability. AskMyDB speeds up routine queries and removes the friction of writing SQL — it doesn't understand business context, tribal knowledge, or when a number is wrong for reasons the schema can't tell you. See [Known Limitations](#known-limitations) below for an honest account of what it can't do.\n\n## What it does\n\nPoint AskMyDB at a PostgreSQL database, and ask questions like \"how many customers do we have\" or \"what's our average order value\" in plain English. It reads your schema automatically (no manual configuration), generates SQL, validates it's safe, runs it read-only, and gives you a plain-English answer back.\n\n## Prerequisites\n\nBefore running AskMyDB, you'll need:\n\n- **Python 3.12+**\n- **A PostgreSQL database** you have credentials for\n- **An LLM provider API key** — Groq, OpenAI, Anthropic, or any provider [`langchain`'s `init_chat_model`](https://python.langchain.com/docs/how_to/chat_models_universal_init/) supports. Note: only `langchain-groq` is installed by default; using another provider requires installing its corresponding LangChain integration package yourself (e.g. `pip install langchain-openai`).\n\n## Installation\n\n```bash\npip install askmydb-mcp\n```\n\nNote: the package is published as `askmydb-mcp` on PyPI, but installs a command called `askmydb` (see Usage below).\n\n## Configuration\n\nSet the following environment variables (e.g. in a `.env` file in your working directory, or exported in your shell):\n\n```bash\n# Database connection\nDB_USER=your_db_user\nDB_PASSWORD=your_db_password\nDB_HOST=localhost\nDB_PORT=5432\nDB_NAME=your_database_name\n\n# Optional: separate read-only credentials (recommended for production use)\n# Falls back to DB_USER/DB_PASS…","publisher":{"name":"Mehul Gupta","url":null},"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:askmydb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["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":"askmydb-mcp","registry":"pypi","observedAt":"2026-09-09T09:25:09.537Z","publishedAt":"2026-08-22T04:29:07.289411Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"askmydb-mcp","url":"https://pypi.org/project/askmydb-mcp/","firstSeenAt":"2026-09-09T09:23:55.369Z","fetchedAt":"2026-09-09T09:23:55.369Z","normalizedAt":"2026-09-09T09:23:55.369Z"}]},"firstSeenAt":"2026-09-09T09:23:55.369Z","updatedAt":"2026-09-09T09:25:09.537Z"}