{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_26uhu3wa2nnk","handle":"soma-mcp","url":"https://wellknown.network/agents/soma-mcp","links":{"self":"https://wellknown.network/agents/soma-mcp/record.json","html":"https://wellknown.network/agents/soma-mcp","markdown":"https://wellknown.network/agents/soma-mcp/record.md","api":"https://wellknown.network/api/v1/agents/soma-mcp","status":"https://wellknown.network/api/v1/agents/soma-mcp/status","claim":"https://wellknown.network/agents/soma-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/soma-mcp/claim.json","badge":"https://wellknown.network/agents/soma-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/soma-mcp/history","tools":"https://wellknown.network/api/v1/agents/soma-mcp/tools"},"ard":{"identifier":"urn:air::server:soma-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"soma-mcp","summary":"MCP server exposing Soma's local SQLite sensor replica to AI agents","description":"# soma-mcp\n\nMCP server that exposes Soma's local Mac SQLite sensor replica to AI agents.\n\nReads from a local SQLite replica maintained by the [Soma Mac app](https://github.com/dylan-buck/Soma). Designed for use with any MCP-compatible agent (Claude, ChatGPT, Cursor, etc.).\n\nIn the App Store-safe build, HealthKit-derived rows are not synced through\nCloudKit, so health tools may return empty or stale data unless the local\nreplica was populated by a future compliant transport. Location and activity\ntools continue to read replicated Mac data.\n\nIf Soma Mac has **Agent Access** turned off, every MCP tool returns a\npermission error with instructions to re-enable access in the Mac app.\nThe local SQLite replica may still exist and continue syncing; the\ntoggle only controls whether `soma-mcp` is allowed to serve it.\n\n## Consumer Setup\n\nFor end users, the Soma Mac app generates the correct MCP configuration automatically from the menu bar.\n\nUntil `soma-mcp` 0.2.1 is published on PyPI, use a local checkout with `uvx --from <path-to-soma-mcp> soma-mcp`. Do not use unpinned `uvx soma-mcp`; PyPI may resolve an older package.\n\n## Development Quick Start\n\n```bash\ncd soma-mcp\nuv run soma-mcp --db ~/.soma/sensors.db\n```\n\n## Agent Configuration\n\nThe Soma Mac app generates the correct config for your machine — open the menu bar and click **Copy Agent Config**. Manual setup is below.\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"soma\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"/path/to/Soma/soma-mcp\", \"soma-mcp\", \"--db\", \"~/.soma/sensors.db\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\nUse the CLI (recommended):\n\n```bash\nclaude mcp add --transport stdio --scope user soma -- uvx --from /path/to/Soma/soma-mcp soma-mcp --db ~/.soma/sensors.db\n```\n\nOr edit `~/.claude.json` (user scope) / `.mcp.json` (project scope) with …","publisher":null,"homepage":"https://github.com/dylan-buck/Soma","repository":"https://github.com/dylan-buck/Soma","version":"0.2.1","license":"MIT","protocols":["mcp"],"tags":["apple-health","health","healthkit","location","mcp","sensor"],"pricing":null,"endpoints":[{"url":"pypi:soma-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["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":"soma-mcp","registry":"pypi","observedAt":"2026-11-22T07:26:05.541Z","publishedAt":"2026-05-01T23:10:35.157353Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"soma-mcp","url":"https://pypi.org/project/soma-mcp/","firstSeenAt":"2026-09-10T12:22:55.193Z","fetchedAt":"2026-11-22T07:25:22.573Z","normalizedAt":"2026-11-22T07:25:22.573Z"}]},"firstSeenAt":"2026-09-10T12:22:55.193Z","updatedAt":"2026-11-22T07:26:05.552Z"}