get_workspace_detailsLABSCO SUMMARY
Enrichment pipelines you already built, driven from the conversation.
The grid stays where it is in BitScale; what changes is who runs it. Discover the grid, ask what inputs it wants, run it, take the results — enrichment for a named company happens in the same thread as the outreach it feeds.
What it is
A server for a BitScale workspace, where the unit of work is a grid — an enrichment or research pipeline with defined inputs. It lists grids, describes their schema, hands back the exact input contract before anything runs, executes a grid in sync or async mode, and polls long runs by request_id.
What you get
- Workspace plan, credit balances, search limits and member counts
- All grids listed with search and pagination, returning their column definitions
- A grid's full schema — columns, settings and data sources
- A ready-to-use curl command and API contract for a grid, so the required inputs are known before it runs
- A grid run with input values, in sync or async mode
- The status of an async or timed-out run, polled by request_id
- The workspace API key rotated, which invalidates the current one
Requirements
A BitScale account and its API key, set as BITSCALE_API_KEY. uv is installed once; uvx then fetches and runs the bitscale-mcp package on demand, so there is nothing to clone or pip install.
Setup effort
One command plus a key — uvx bitscale-mcp, then supply credentials
USE CASES
01
Finding the grid that does the job
List the workspace's grids with their column definitions, so you pick the right pipeline before running anything.
02
Knowing what a grid needs before running it
Read back the required input fields and a shaped request body, rather than guessing and paying for a failed run.
03
Enriching a company on the spot
Pass the input values as the human-readable labels the contract returned; in sync mode the results come straight back.
04
Following a long run to completion
A run that goes async or times out returns a request_id — poll it until the results are ready.
05
Checking there is credit left
Read the plan, credit balance and search limits before committing to a large batch.
06
Cycling the workspace key
Rotate it from the client; the current key stops working at that moment, so update the config in the same sitting.
7 tools
Listed in project docs. Your client may show a different list.
list_gridsget_grid_detailsget_grid_curlrun_gridget_run_statusrotate_api_keyBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
- uvx on PATH
- BITSCALE_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx bitscale-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"bitscale": {
"command": "uvx",
"args": [
"bitscale-mcp"
],
"env": {
"BITSCALE_API_KEY": "<YOUR_BITSCALE_API_KEY>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add bitscale \
--command uvx \
--args bitscale-mcp \
--env BITSCALE_API_KEY=<YOUR_BITSCALE_API_KEY>
