{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nvxr88mbsmwf","handle":"pgsql-mcp","url":"https://wellknown.network/agents/pgsql-mcp","links":{"self":"https://wellknown.network/agents/pgsql-mcp/record.json","html":"https://wellknown.network/agents/pgsql-mcp","markdown":"https://wellknown.network/agents/pgsql-mcp/record.md","api":"https://wellknown.network/api/v1/agents/pgsql-mcp","status":"https://wellknown.network/api/v1/agents/pgsql-mcp/status","claim":"https://wellknown.network/agents/pgsql-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pgsql-mcp/claim.json","badge":"https://wellknown.network/agents/pgsql-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:pgsql-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pgsql-mcp","summary":"A Model Context Protocol server for PostgreSQL with read-only default and super-code write access.","description":"# pgsql-mcp\n\nA Model Context Protocol (MCP) server for PostgreSQL. Provides read-only database access by default, with optional write operations gated behind a super code.\n\n## Overview\n\npgsql-mcp exposes PostgreSQL databases to MCP-compatible AI clients (such as Claude, Kiro, and Cursor) through a set of structured tools. It supports schema inspection, table browsing, row fetching, arbitrary query execution, and stored function/procedure invocation.\n\nWrite and DDL operations are disabled unless a super code is provided at server startup. This ensures safe, read-only access in environments where unrestricted database modification is not desired.\n\n## Installation\n\n```bash\npip install pgsql-mcp\n```\n\n## Usage\n\nStart the server with a PostgreSQL DSN:\n\n```bash\n# Read-only mode (default)\npgsql-mcp --dsn \"postgresql://user:password@localhost:5432/mydb\"\n\n# With write access enabled\npgsql-mcp --dsn \"postgresql://user:password@localhost:5432/mydb\" --super-code \"your-secret\"\n```\n\n### Command-Line Arguments\n\n| Argument | Required | Description |\n|----------|----------|-------------|\n| `--dsn` | Yes | PostgreSQL connection string in DSN format |\n| `--super-code` | No | Secret code to unlock write and DDL operations |\n\n## MCP Client Configuration\n\nAdd the following to your MCP client configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"postgres\": {\n      \"command\": \"pgsql-mcp\",\n      \"args\": [\n        \"--dsn\", \"postgresql://user:password@localhost:5432/mydb\"\n      ],\n      \"autoApprove\": [\n        \"list_schemas\",\n        \"list_tables\",\n        \"describe_table\",\n        \"fetch_rows\",\n        \"run_query\",\n        \"call_function\"\n      ]\n    }\n  }\n}\n```\n\n## Tools\n\n### list_schemas\n\nList all non-system schemas in the database.\n\n**Parameters:** None\n\n### list_tables\n\nList all tables in a given schema.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| schema | string | \"public\" | Schema name |\n\n### describe_table\n\nDescribe columns of a table,…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:pgsql-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"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":"pgsql-mcp","registry":"pypi","observedAt":"2026-09-10T09:27:03.387Z","publishedAt":"2026-04-29T18:06:09.485142Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pgsql-mcp","url":"https://pypi.org/project/pgsql-mcp/","firstSeenAt":"2026-09-10T09:26:13.266Z","fetchedAt":"2026-09-10T09:26:13.266Z","normalizedAt":"2026-09-10T09:26:13.266Z"}]},"firstSeenAt":"2026-09-10T09:26:13.266Z","updatedAt":"2026-09-10T09:27:03.387Z"}