{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vwkp62etnjba","handle":"qvasa-mcp","url":"https://wellknown.network/agents/qvasa-mcp","links":{"self":"https://wellknown.network/agents/qvasa-mcp/record.json","html":"https://wellknown.network/agents/qvasa-mcp","markdown":"https://wellknown.network/agents/qvasa-mcp/record.md","api":"https://wellknown.network/api/v1/agents/qvasa-mcp","status":"https://wellknown.network/api/v1/agents/qvasa-mcp/status","claim":"https://wellknown.network/agents/qvasa-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/qvasa-mcp/claim.json","badge":"https://wellknown.network/agents/qvasa-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/qvasa-mcp/history","tools":"https://wellknown.network/api/v1/agents/qvasa-mcp/tools"},"ard":{"identifier":"urn:air::server:qvasa-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"qvasa-mcp","summary":"MCP server that exposes the Qvasa user-access agentic API to Claude.","description":"# qvasa-mcp\n\nMCP server that exposes the Qvasa user-access agentic API to Claude.\n\nThis is a thin proxy: Claude sends MCP tool calls over stdio, the server translates each call into one or more HTTP requests against the Qvasa Rails app, and returns the result. It owns session lifecycle (login, refresh on 401 SessionStale, two-token auth) so Claude doesn't have to.\n\nRails counterpart: `one_qvasa_app` repo, namespace `/user_access/api/*`. The toolkit version constant lives at `app/services/user_access/api/toolkit_version.rb`.\n\n## Configuration\n\nSet these env vars (Claude Desktop injects them from the `.mcpb` config block on install):\n\n| var | required | default | purpose |\n| --- | --- | --- | --- |\n| `QVASA_API_KEY` | yes | — | A user-access token (UAT). Generate at `/user_settings/user_access_tokens` in the Qvasa UI. Format `qva_uat_…`. |\n| `QVASA_API_BASE_URL` | no | `https://qvasa.com` | Override for staging or local dev (e.g. `http://localhost:3000`). |\n\n## Local dev\n\n```sh\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e '.[dev]'\n\nexport QVASA_API_KEY=qva_uat_…\nexport QVASA_API_BASE_URL=http://localhost:3000\n\n# Run the server (it will read MCP requests on stdin, write responses on stdout).\nqvasa-mcp\n\n# Run the tests.\npytest\n```\n\n## Tool list (17 total)\n\n**Orientation**\n- `qvasa_overview` — call this FIRST. Returns positioning, intent triggers, intent-keyed workflows, a feedback guide, and the cached session manifest. One call per session; no HTTP round-trip after the first.\n- `qvasa_submit_feedback` — frictionless channel for filing bug reports, feature requests, friction points, unexpected_behavior notes, and impossibility reports back to Qvasa engineering.\n- `qvasa_search_saved_widgets` — search the user's personal-dashboard saved queries (the agent's memory layer). Call BEFORE rebuilding a metric from scratch.\n\n**Discovery — widgets** (unified: search by phrase, browse a group, or list all groups)\n- `qvasa_search_widgets` — pass `query` to searc…","publisher":{"name":"Qvasa","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"Proprietary","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:qvasa-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":"analytics.reporting","name":"Reporting & Dashboards","confidence":0.814,"provenance":"derived"}],"categories":["analytics"],"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":"qvasa-mcp","registry":"pypi","observedAt":"2026-10-28T20:23:21.823Z","publishedAt":"2026-05-14T16:38:32.583769Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"qvasa-mcp","url":"https://pypi.org/project/qvasa-mcp/","firstSeenAt":"2026-09-10T10:25:20.467Z","fetchedAt":"2026-10-28T20:22:44.296Z","normalizedAt":"2026-10-28T20:22:44.296Z"}]},"firstSeenAt":"2026-09-10T10:25:20.467Z","updatedAt":"2026-10-28T20:23:21.823Z"}