{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hu7paqdyvfr8","handle":"ba-agent-mcp","url":"https://wellknown.network/agents/ba-agent-mcp","links":{"self":"https://wellknown.network/agents/ba-agent-mcp/record.json","html":"https://wellknown.network/agents/ba-agent-mcp","markdown":"https://wellknown.network/agents/ba-agent-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ba-agent-mcp","status":"https://wellknown.network/api/v1/agents/ba-agent-mcp/status","claim":"https://wellknown.network/agents/ba-agent-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ba-agent-mcp/claim.json","badge":"https://wellknown.network/agents/ba-agent-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:ba-agent-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ba-agent-mcp","summary":"MCP server exposing the Modern-Expo virtual Business Analyst Knowledge Base (read/derive tools).","description":"# ba-agent-mcp \n \nAn [MCP](https://modelcontextprotocol.io) server that exposes the Modern-Expo \nvirtual **Business Analyst Knowledge Base** as a small set of **read / derive** \ntools. It never writes to SUPPA Docs or the Knowledge Base and is deliberately \nkept off the governed write path — authoring documents goes through the \nhuman-gated `business-analyst` skill, not this server. \n \n## Install \n \n```bash \nuvx ba-agent-mcp          # run on demand in an isolated environment (recommended) \n# or \npip install ba-agent-mcp  # then run: ba-agent-mcp \n``` \n \n## Credentials — you supply your own \n \n**This package ships no credentials.** Each user provides their **own** keys and \ntheir **own** SUPPA identity. Nothing is ever read from the MCP client JSON \nconfig; secrets are resolved from the environment, in this order: \n \n1. real environment variables in the launching shell, then \n2. an explicit env file at `$BA_AGENT_ENV_FILE`, then \n3. `~/.ba-agent/.env` \n \n```bash \n# ~/.ba-agent/.env   (or export these in your shell) \nSUPABASE_URL=https://<your-project>.supabase.co \nSUPABASE_SERVICE_ROLE_KEY=...        # or SUPABASE_ANON_KEY for read-only \nSUPPA_API_KEY=...                    # your own SUPPA identity (or SUPPA_TOKEN) \nGEMINI_API_KEY=...                   # optional — enables hybrid (vector) search \nFIGMA_TOKEN=...                      # optional — enables analyze_figma \n``` \n \n> Never put any secret in the MCP client JSON. A tool whose credentials are \n> absent returns a clear, structured error instead of failing the server, so you \n> can add capabilities incrementally. \n \n## Connect (any MCP client) \n \n```json \n{ \n  \"mcpServers\": { \n    \"ba-agent\": { \n      \"command\": \"uvx\", \n      \"args\": [\"ba-agent-mcp\"], \n      \"env\": { \"BA_AGENT_ENV_FILE\": \"/absolute/path/to/your/.env\" } \n    } \n  } \n} \n``` \n \n## Tools \n \n| Tool | Returns | \n| --- | --- | \n| `kb_search` | Ranked KB hits with provenance (title, breadcrumb, SUPPA anchor, `data_class`). | \n| `kb_assemble_context` …","publisher":{"name":"Modern-Expo","url":null},"homepage":null,"repository":null,"version":"0.3.2","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","business-analyst","knowledge-base","rag"],"pricing":null,"endpoints":[{"url":"pypi:ba-agent-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"security.secrets","name":"Secrets Management","confidence":0.848,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["data","dev","security"],"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":"ba-agent-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:09.710Z","publishedAt":"2026-07-15T08:53:11.421880Z","latestVersion":"0.3.2"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ba-agent-mcp","url":"https://pypi.org/project/ba-agent-mcp/","firstSeenAt":"2026-09-09T10:26:23.965Z","fetchedAt":"2026-09-09T10:26:23.965Z","normalizedAt":"2026-09-09T10:26:23.965Z"}]},"firstSeenAt":"2026-09-09T10:26:23.965Z","updatedAt":"2026-09-09T10:29:09.710Z"}