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-operator-token> \
  -- /absolute/path/to/VectorStep-Gateway-MCP/.venv/bin/python -m vectorstep_gateway_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, write-path design notes for both MCP servers
Gateway Agent authoring (agent.yaml, soul.md) that this server exposes

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 Gateway 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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for bantex from gravatar.com bantex

Credits

Author: Alex Dalton

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp vectorstep ai agents gateway llm

Classifiers

Report project as malware

Download files

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

Source Distribution

vectorstep_gateway_mcp-0.1.0.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

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

vectorstep_gateway_mcp-0.1.0-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

Details for the file vectorstep_gateway_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: vectorstep_gateway_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vectorstep_gateway_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f5387a6cb118dfeba3ca2c3500b1fb74a54b156e44848c488ccc843aafa5cb59
MD5 1027a93beb5961ff80e3c7714ca2617a
BLAKE2b-256 9fb46268c507673c965cece89655b83940bd93810570ce7dfba62f61d3469aab

See more details on using hashes here.

Provenance

The following attestation bundles were made for vectorstep_gateway_mcp-0.1.0.tar.gz:

Publisher: publish.yml on bantex01/VectorStep-Gateway-MCP

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vectorstep_gateway_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for vectorstep_gateway_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 81c25c3fe013c97d20d09f3a98b2df206d6b5e8d5bdab67fc189968bcf64b55a
MD5 7512e54dee5441fb1c372dccf1512b9b
BLAKE2b-256 a13d63ebf1fa3da13071e21184198b3a72f6ce80f6235f6646680ce9d19f0199

See more details on using hashes here.

Provenance

The following attestation bundles were made for vectorstep_gateway_mcp-0.1.0-py3-none-any.whl:

Publisher: publish.yml on bantex01/VectorStep-Gateway-MCP

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page