# VendorOps MCP

VendorOps is a Model Context Protocol (MCP) server for a synthetic internal
vendor-management workflow. It gives AI applications structured access to
vendor records, contracts, spending, renewals, and security reviews.

The project is intentionally built in small, reviewable slices. Phase 1 uses
Python, the official MCP Python SDK, SQLite, Pydantic, and pytest to expose
read-only vendor data over a local stdio connection.

All vendor and contract data in this repository is synthetic.

## Development

Install the locked dependencies:

```bash
uv sync
```

Run the test suite:

```bash
uv run pytest
```

Run the local stdio server:

```bash
uv run vendorops-mcp
```

The server waits for an MCP host to send protocol messages over stdin. It does
not open a network port or print a user interface.

By default, VendorOps creates `data/vendorops.db` and seeds it with 30 synthetic
vendors. Set `VENDOROPS_DB_PATH` to use a different SQLite file.

## Current MCP Capabilities

### Tools

- `search_vendors`: Search vendor records by name, category, or owner, with
  optional category and status filters.