{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2dbzfyczjpkx","handle":"greybeam-mcp","url":"https://wellknown.network/agents/greybeam-mcp","links":{"self":"https://wellknown.network/agents/greybeam-mcp/record.json","html":"https://wellknown.network/agents/greybeam-mcp","markdown":"https://wellknown.network/agents/greybeam-mcp/record.md","api":"https://wellknown.network/api/v1/agents/greybeam-mcp","status":"https://wellknown.network/api/v1/agents/greybeam-mcp/status","claim":"https://wellknown.network/agents/greybeam-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/greybeam-mcp/claim.json","badge":"https://wellknown.network/agents/greybeam-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:greybeam-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"greybeam-mcp","summary":"MCP server that routes SQL queries through the Greybeam proxy while delegating Cortex Search to upstream Snowflake MCP.","description":"# Greybeam MCP\n\nA single MCP server that lets agents query data through the Greybeam routing layer with Snowflake-compatible tooling.\n\n- `run_snowflake_query` — executes SQL via the Greybeam proxy (Snowflake protocol).\n- `cortex_analyst` — calls Snowflake Cortex Analyst; any returned SQL is executed via Greybeam.\n- `cortex_search` — delegated to the pinned upstream Snowflake MCP (no SQL, REST only).\n\nOut of scope for v1: Cortex Agent, semantic views, and the upstream `object_manager` / `query_manager` / `semantic_manager` tool families. These are locked off in the child config so a misconfigured deployment can't accidentally expose them.\n\n## Quick start\n\nInstall and run the setup wizard with [`uv`](https://docs.astral.sh/uv/):\n\n    uvx greybeam-mcp init\n\nThe `init` wizard prompts for account, user, proxy host, and auth method;\nwrites a config file at `~/.config/greybeam-mcp.yaml` (mode 0600); and prints\nthe exact registration command for Claude Code and Claude Desktop.\n\nFor a packaged install, the printed command uses this form:\n\n    claude mcp add greybeam -- uvx greybeam-mcp --config ~/.config/greybeam-mcp.yaml\n\n## Manual install and run\n\nIf you'd rather author the YAML by hand, copy `examples/greybeam.yaml` to a\nlocation of your choice, edit it, `chmod 600` it, then:\n\n    uvx greybeam-mcp --config /absolute/path/to/greybeam.yaml\n\nFrom a source checkout, use `uv run` instead:\n\n    uv run greybeam-mcp --config /absolute/path/to/greybeam.yaml\n\n## Configuration\n\nThe YAML is the single source of truth — it holds account, proxy host, **and**\nauth credentials. Pick one auth method (in order of recommendation):\n\n- `private_key_file` (path to a PEM key, plus optional `private_key_passphrase`) — **recommended**, since Snowflake is deprecating password auth\n- `private_key` (inline PEM contents) — for environments without a writable disk\n- `authenticator: externalbrowser` for SSO (requires a SAML2 integration on the account)\n- `password` — deprecated by Snowflake, avoid for…","publisher":{"name":"Greybeam","url":null},"homepage":"https://github.com/greybeam/mcp","repository":"https://github.com/greybeam/mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["greybeam","mcp","model-context-protocol","snowflake"],"pricing":null,"endpoints":[{"url":"pypi:greybeam-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","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.722,"provenance":"derived"}],"categories":["ai","data","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":"greybeam-mcp","registry":"pypi","observedAt":"2026-09-09T16:25:45.685Z","publishedAt":"2026-04-26T02:47:00.356671Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"greybeam-mcp","url":"https://pypi.org/project/greybeam-mcp/","firstSeenAt":"2026-09-09T16:24:57.628Z","fetchedAt":"2026-09-09T16:24:57.628Z","normalizedAt":"2026-09-09T16:24:57.628Z"}]},"firstSeenAt":"2026-09-09T16:24:57.628Z","updatedAt":"2026-09-09T16:25:45.685Z"}