VectorStep Service MCP
An MCP server that exposes VectorStep — pipeline authoring, run inspection, and analytics — 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 VectorStep — the two are coupled only over HTTP, so each can be developed, versioned, and deployed independently.
It lets an MCP client create and edit pipelines and step-library definitions (with the same validation VectorStep itself uses), inspect runs and steps, answer operational and quality questions, and trigger runs or submit human feedback. Agents are not authored here — that's the job of the companion VectorStep-Gateway-MCP; this server may only read agents, to help author pipelines that reference them.
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 VectorStep instance:
claude mcp add vectorstep-service \
--env VECTORSTEP_BASE_URL=http://127.0.0.1:8000 \
-- /absolute/path/to/VectorStep-Service-MCP/.venv/bin/python -m vectorstep_service_mcp
Full install, client config (Claude Code, Claude Desktop, MCP Inspector), and tool inventory: MCP servers.
Documentation
Full docs at vectorstep.io:
| Section | Covers |
|---|---|
| MCP servers | Install, client config, tool inventory, explain tool, write-path design notes for both MCP servers |
| Pipelines | The pipeline/step schema this server authors against |
The ecosystem
| Repo | Role |
|---|---|
| VectorStep | The orchestration service: webhook intake, pipeline runner, trust gating, UI, analytics |
| VectorStep-Gateway | WebSocket gateway that runs agents: LLM providers, MCP tools, the full agentic loop |
| VectorStep-Service-MCP | MCP server exposing pipeline authoring, run inspection and analytics to Claude Code/Desktop |
| VectorStep-Gateway-MCP | MCP server for authoring and inspecting Gateway agents |
Licence
VectorStep Service MCP is proprietary software, free to download and use under the terms in LICENSE. The source is not publicly distributed and this repository is private.
Bug reports, questions, and feature requests are welcome at alex@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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vectorstep_service_mcp-0.1.0.tar.gz.
File metadata
- Download URL: vectorstep_service_mcp-0.1.0.tar.gz
- Upload date:
- Size: 36.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f61412c4da00692309abdebd59c1d6ce7354d505cf3dd4d4666adb34180b3f1
|
|
| MD5 |
21e95902aa7110a2ee8fed15249db0a2
|
|
| BLAKE2b-256 |
91a20d0ceef83a49d208c1d22f1dc0374c8f5a1846328af0017ffa97f559f2e9
|
Provenance
The following attestation bundles were made for vectorstep_service_mcp-0.1.0.tar.gz:
Publisher:
publish.yml on bantex01/VectorStep-Service-MCP
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vectorstep_service_mcp-0.1.0.tar.gz -
Subject digest:
3f61412c4da00692309abdebd59c1d6ce7354d505cf3dd4d4666adb34180b3f1 - Sigstore transparency entry: 2728247793
- Sigstore integration time:
-
Permalink:
bantex01/VectorStep-Service-MCP@5dd96e358aeaa533c69981f9b89ef2d6a9cc5213 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bantex01
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@5dd96e358aeaa533c69981f9b89ef2d6a9cc5213 -
Trigger Event:
push
-
Statement type:
File details
Details for the file vectorstep_service_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: vectorstep_service_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 33.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0aa51ac2ad7ec9d92e666ec715d91cb79468dda493e606cdef9657b4d06d7977
|
|
| MD5 |
8c67a66a75251108625a284edc5905e1
|
|
| BLAKE2b-256 |
936905957e74863c69d3ccf79b8a3c2ef815e4d289aba5cc1f0e802d9d0a832e
|
Provenance
The following attestation bundles were made for vectorstep_service_mcp-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on bantex01/VectorStep-Service-MCP
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
vectorstep_service_mcp-0.1.0-py3-none-any.whl -
Subject digest:
0aa51ac2ad7ec9d92e666ec715d91cb79468dda493e606cdef9657b4d06d7977 - Sigstore transparency entry: 2728247906
- Sigstore integration time:
-
Permalink:
bantex01/VectorStep-Service-MCP@5dd96e358aeaa533c69981f9b89ef2d6a9cc5213 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bantex01
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@5dd96e358aeaa533c69981f9b89ef2d6a9cc5213 -
Trigger Event:
push
-
Statement type: