Skip to main content

Concierge text2sql MCP server — connects Claude (and other MCP clients) to the Concierge BigQuery assistant over stdio.

Project description

jobescape-concierge

Concierge text2sql MCP server. Connects Claude (and any MCP-compatible client) to the Concierge BigQuery assistant over stdio — no repo clone, no database or cloud credentials required.

Requirements

  • uv installed (for uvx)
  • A Concierge API token (request one from the Concierge admin; tokens are tied to your @nvs.team email)

Add to Claude Desktop / Claude Code

claude mcp add concierge \
  -e CONCIERGE_API_TOKEN=t2s_... \
  -- uvx jobescape-concierge

Or edit claude_desktop_config.json directly:

{
  "mcpServers": {
    "concierge": {
      "command": "uvx",
      "args": ["jobescape-concierge"],
      "env": {
        "CONCIERGE_API_TOKEN": "t2s_..."
      }
    }
  }
}

Replace t2s_... with your actual token, then fully quit and reopen Claude Desktop.

Local development

Point the server at a locally running Concierge instance:

CONCIERGE_API_TOKEN=t2s_... CONCIERGE_MCP_URL=http://localhost:8080/mcp/ uvx jobescape-concierge

Environment variables

Variable Required Default Description
CONCIERGE_API_TOKEN Yes Plaintext API token (t2s_... prefix).
CONCIERGE_MCP_URL No https://concierge-yh7apzuicq-ue.a.run.app/mcp/ Base URL for the Concierge MCP endpoint. Use a localhost URL for local dev.

How it works

On startup the server connects to the Concierge cloud MCP endpoint over HTTPS, validates your token, and fetches the available tool list. It then re-serves those tools over the MCP stdio protocol and forwards every tool call to the cloud. No SQL, schema, or credentials live in this package — all data access happens server-side.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jobescape_concierge-0.1.1.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jobescape_concierge-0.1.1-py3-none-any.whl (4.2 kB view details)

Uploaded Python 3

File details

Details for the file jobescape_concierge-0.1.1.tar.gz.

File metadata

  • Download URL: jobescape_concierge-0.1.1.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for jobescape_concierge-0.1.1.tar.gz
Algorithm Hash digest
SHA256 82e9f7726fd478969853762d083c72c8871ca9b7c492b075ca4c715c3df1071d
MD5 7c53bb47ea5a123fa677cb932eda611c
BLAKE2b-256 13b4051ff7e47532ebfc3908fbe0592856294fe6580aa9c8725ec6f4309ab63b

See more details on using hashes here.

File details

Details for the file jobescape_concierge-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: jobescape_concierge-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for jobescape_concierge-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6f35024e9172d73c8e6c7eabec3540b94ba849f3d630b185748869e945134e58
MD5 cdc5d6ff6bbbfcd0f5a4531bfc3897ce
BLAKE2b-256 b7e1087bd33c8a9894eecef0b7034c2bdb2915b3add61a8e6e6c3ee61df29b03

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page