Metadata-Version: 2.4
Name: vectorstep-service-mcp
Version: 0.1.0
Summary: MCP server exposing VectorStep's authoring, inspection, and analytics 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,orchestration,pipelines
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 Service MCP

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

```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 VectorStep instance:

```bash
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](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, `explain` tool, write-path design notes for both MCP servers |
| [Pipelines](https://vectorstep.io/docs/pipelines/schema/) | 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`](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.
