VectorStep Gateway MCP

An MCP server that exposes VectorStep Gateway — agent authoring and inspection — to MCP clients such as Claude Code and Claude Desktop.

What it is

A separate, standalone repository and process with no import-level dependency on the Gateway — the two are coupled only over HTTP, so each can be developed, versioned, and deployed independently.

It lets an MCP client create and edit agents (agent.yaml + soul.md, with the same validation the gateway itself uses), inspect what's available (configured MCP tool servers and their tools, configured LLM providers), and read gateway health/metrics. Pipelines/steps are not authored here — that's the job of the companion VectorStep-Service-MCP; the two have clean, non-overlapping tool sets.

Quick start

python3 -m venv .venv
.venv/bin/pip install -e .

CI runs this repo's test suite on every push and pull request (.github/workflows/tests.yml).

Then register it with your MCP client, pointing at a running Gateway instance:

claude mcp add vectorstep-gateway \
  --env GATEWAY_BASE_URL=http://127.0.0.1:18780 \
  --env GATEWAY_OPERATOR_TOKEN=<your-admin-token> \
  -- /absolute/path/to/VectorStep-Gateway-MCP/.venv/bin/python -m vectorstep_gateway_mcp

GATEWAY_OPERATOR_TOKEN must be the Gateway's admin token, not its invoke token — every tool this server exposes (creating/editing agents, /reload, even POST /agents/validate) needs the admin scope. The Gateway prints both tokens on first boot (admin and invoke); the invoke token is for the VectorStep service's own executors.gateway.token, not for this MCP server. See Gateway authentication.

If the Gateway is running via the VectorStep-Dist Docker Compose stack, GATEWAY_BASE_URL=http://127.0.0.1:18780 won't resolve — that stack no longer publishes the Gateway's port to the host by default. Add a ports: entry to the compose file's gateway service and docker compose up -d to apply it; see that repo's README.

Full install, client config (Claude Code, Claude Desktop, MCP Inspector), and tool inventory: MCP servers.

Documentation

Full docs at vectorstep.io:

The ecosystem

Licence

VectorStep Gateway MCP is proprietary software, free to download and use under the terms in LICENSE. It's installable from PyPI — that's the Licensor's own distribution channel, not a grant for you to redistribute it further — and this GitHub repository is private.

Bug reports, questions, and feature requests are welcome at contact@vectorstep.io. Code contributions are not accepted — see clause 6 of the licence. For a suspected vulnerability, follow SECURITY.md rather than emailing the address above.