{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kmakcrb2axdy","handle":"phenoworks-mcp","url":"https://wellknown.network/agents/phenoworks-mcp","links":{"self":"https://wellknown.network/agents/phenoworks-mcp/record.json","html":"https://wellknown.network/agents/phenoworks-mcp","markdown":"https://wellknown.network/agents/phenoworks-mcp/record.md","api":"https://wellknown.network/api/v1/agents/phenoworks-mcp","status":"https://wellknown.network/api/v1/agents/phenoworks-mcp/status","claim":"https://wellknown.network/agents/phenoworks-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/phenoworks-mcp/claim.json","badge":"https://wellknown.network/agents/phenoworks-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/phenoworks-mcp/history","tools":"https://wellknown.network/api/v1/agents/phenoworks-mcp/tools"},"ard":{"identifier":"urn:air::server:phenoworks-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"phenoworks-mcp","summary":"Connect AI assistants to PhenoWorks projects, datasets, and analysis pipelines through MCP.","description":"# PhenoWorks MCP\n\nConnect your AI assistant to PhenoWorks with the Model Context Protocol (MCP).\nThe assistant can find projects and datasets, inspect analysis modules, run\npipelines, and retrieve results using your PhenoWorks account permissions.\n\nThis package runs the MCP server that your assistant connects to. You need a\nrunning PhenoWorks server and an MCP-compatible assistant; installing this\npackage does not install PhenoWorks or provide an AI model.\n\n## Before you start\n\n- Use **Python 3.11 or newer**.\n- Have your PhenoWorks server URL, such as `https://your-phenoworks-server`.\n- Create an API key in your PhenoWorks account settings.\n\nYour server URL is the address of your own PhenoWorks installation, not the\npublic documentation website. Both the server root and a URL ending in `/api`\nare accepted.\n\n## Install\n\nInstall from PyPI in a Python virtual environment:\n\n```bash\npip install phenoworks-mcp\nphenoworks-mcp --help\n```\n\nThe PhenoWorks Python SDK and MCP runtime are installed automatically. To\nupgrade an existing installation, run `pip install --upgrade phenoworks-mcp`.\n\nIf you already use [uv](https://docs.astral.sh/uv/), you can run the package\nwithout a separate install command:\n\n```bash\nuvx phenoworks-mcp --help\n```\n\n## Connect to Claude Desktop\n\nFollow the [Claude Desktop setup tutorial](docs/claude-desktop.md) to create a\ndedicated uv environment, configure your local PhenoWorks connection, and start\nchatting with Claude.\n\n## Connect over local HTTP\n\nFor a client that accepts a Streamable HTTP MCP URL, start the server in a\nterminal. For example, in a macOS or Linux shell:\n\n```bash\nexport PHENOWORKS_API_BASE_URL=\"https://your-phenoworks-server\"\nexport PHENOWORKS_PUBLIC_URL=\"https://your-phenoworks-app\"\nexport PHENOWORKS_API_KEY=\"YOUR_API_KEY\"\nphenoworks-mcp\n```\n\nLeave the process running and add this **MCP server URL** to your assistant:\n\n```text\nhttp://127.0.0.1:8787/mcp\n```\n\nThere are three relevant URLs: `PHENOWORKS_API_BASE_URL` points to the\nPh…","publisher":null,"homepage":"https://phenoworks.org/docs","repository":"https://github.com/OpenSciML/phenoworks/issues","version":"0.5.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:phenoworks-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"},{"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":"phenoworks-mcp","registry":"pypi","observedAt":"2026-10-24T18:28:58.265Z","publishedAt":"2026-10-10T18:20:54.310976Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"phenoworks-mcp","url":"https://pypi.org/project/phenoworks-mcp/","firstSeenAt":"2026-09-24T10:28:00.963Z","fetchedAt":"2026-10-24T18:28:03.223Z","normalizedAt":"2026-10-24T18:28:03.223Z"}]},"firstSeenAt":"2026-09-24T10:28:00.963Z","updatedAt":"2026-10-24T18:28:58.265Z"}