Metadata-Version: 2.4
Name: vectorstep-gateway-mcp
Version: 0.1.0
Summary: MCP server exposing VectorStep Gateway's agent-management and introspection surface to MCP clients (Claude Code/Desktop).
Author-email: Alex Dalton <alex@vectorstep.io>
License-Expression: MIT
Project-URL: Homepage, https://vectorstep.io
Project-URL: Documentation, https://vectorstep.io/docs/integrations/mcp/
Project-URL: Changelog, https://vectorstep.io/docs/about/status-and-support/
Keywords: mcp,vectorstep,ai,agents,gateway,llm
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp==1.28.1
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Dynamic: license-file

# VectorStep Gateway MCP

An [MCP](https://modelcontextprotocol.io) server that exposes [VectorStep Gateway](https://github.com/bantex01/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

```bash
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:

```bash
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](https://vectorstep.io/docs/integrations/mcp/).

## Documentation

Full docs at [vectorstep.io](https://vectorstep.io/docs/):

| Section | Covers |
|---|---|
| [MCP servers](https://vectorstep.io/docs/integrations/mcp/) | Install, client config, tool inventory, write-path design notes for both MCP servers |
| [Gateway](https://vectorstep.io/docs/gateway/agents/) | 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`](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`](SECURITY.md) rather than emailing the address above.
