{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ee9h5a8dyjay","handle":"gsheets-mcp","url":"https://wellknown.network/agents/gsheets-mcp","links":{"self":"https://wellknown.network/agents/gsheets-mcp/record.json","html":"https://wellknown.network/agents/gsheets-mcp","markdown":"https://wellknown.network/agents/gsheets-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gsheets-mcp","status":"https://wellknown.network/api/v1/agents/gsheets-mcp/status","claim":"https://wellknown.network/agents/gsheets-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gsheets-mcp/claim.json","badge":"https://wellknown.network/agents/gsheets-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/gsheets-mcp/history","tools":"https://wellknown.network/api/v1/agents/gsheets-mcp/tools"},"ard":{"identifier":"urn:air::server:gsheets-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gsheets-mcp","summary":"Strict, agent-friendly MCP server for Google Sheets operations","description":"# gsheets-mcp\n\nA strict, agent-friendly MCP server for Google Sheets. Version `1.0.0` exposes\nwire contract `1.0` through one explicit CLI and direct structured results.\n\n## Tool contract\n\n| Tool | Inputs | Broker | Local |\n|---|---|---:|---:|\n| `gsheets_list_tabs` | `spreadsheet` | yes | yes |\n| `gsheets_read_range` | `spreadsheet`, `range`, optional render options | yes | yes |\n| `gsheets_write_range` | `spreadsheet`, `range`, `values` | yes | yes |\n| `gsheets_append_rows` | `spreadsheet`, `range`, `values` | yes | yes |\n| `gsheets_create_spreadsheet` | `title` | yes | yes |\n| `gsheets_copy_spreadsheet` | source `spreadsheet`, destination `title`, optional `tabs` | yes | yes |\n| `gsheets_search_spreadsheets` | `query`, optional `limit` | no | yes |\n| `gsheets_clear_range` | `spreadsheet`, `range` | yes | yes |\n| `gsheets_recalculate_range` | `spreadsheet`, `range` | yes | yes |\n\n`spreadsheet` accepts only a spreadsheet ID or a strict\n`https://docs.google.com/spreadsheets/...` URL. Common tools never treat a title\nas an identifier. In local mode, search by title first and pass the selected\n`results[n].spreadsheet` ID to the next tool. `range` is A1 notation, preferably\nincluding the tab (for example, `Comps!A1:H20`).\n\nInputs are closed-world, strictly typed JSON. Unknown fields—including plausible\nfields such as `dry_run` and `idempotency_key`—are rejected. `values` must be a\nnon-empty two-dimensional JSON array, not a JSON-encoded string.\n\n## Results and failures\n\nSuccessful calls return a direct object rather than JSON inside a string:\n\n```json\n{\n  \"status\": \"ok\",\n  \"operation\": \"gsheets_read_range\",\n  \"spreadsheet\": \"1AbCdEf...\",\n  \"range\": \"Comps!A1:B2\",\n  \"value_render_option\": \"FORMATTED_VALUE\",\n  \"date_time_render_option\": \"FORMATTED_STRING\",\n  \"values\": [[\"Ticker\", \"PCTY\"], [\"Revenue\", 100]]\n}\n```\n\nOperational and validation failures set MCP `isError=true`. The structured\ncontent carries a stable code plus explicit outcome and retry guidance:\n\n```json\n{\n  …","publisher":{"name":"Henry Chien","url":null},"homepage":null,"repository":null,"version":"1.0.1","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:gsheets-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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.905,"provenance":"derived"}],"categories":["documents"],"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":"gsheets-mcp","registry":"pypi","observedAt":"2026-10-28T02:26:47.571Z","publishedAt":"2026-09-15T19:27:55.953309Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gsheets-mcp","url":"https://pypi.org/project/gsheets-mcp/","firstSeenAt":"2026-09-09T17:20:20.676Z","fetchedAt":"2026-10-28T02:25:17.765Z","normalizedAt":"2026-10-28T02:25:17.765Z"}]},"firstSeenAt":"2026-09-09T17:20:20.676Z","updatedAt":"2026-10-28T02:26:47.571Z"}