sop-mcp

An MCP server that brings process automation to AI agents through Standard Operating Procedures.

LLMs are powerful but unpredictable when executing multi-step processes — they skip steps, summarize instead of act, and lose track of where they are. sop-mcp solves this by delivering procedures one step at a time, forcing the agent to execute each step and provide concrete output before advancing. This turns SOPs into a control mechanism that makes LLM behavior predictable and auditable.

The result: agents that follow processes the way humans do — step by step, with reasoning enforced at each level.

This approach aligns with Agent SOPs — a standardized markdown format for defining AI agent workflows using RFC 2119 requirement levels (MUST, SHOULD, MAY). sop-mcp adds the execution layer: an MCP server that delivers these procedures one step at a time and enforces completion before advancing.

Install

Kiro	Cursor	VS Code

Or add manually:

{
  "mcpServers": {
    "sop-mcp": {
      "command": "uvx",
      "args": ["sop-mcp"],
      "env": { "SOP_STORAGE_DIR": "/path/to/your/sops" }
    }
  }
}

How It Works

Every session starts the same way — discover what's available, then execute.

list_resources()                                     → catalog of sop:// URIs
run_sop(sop_name="sop_creation_guide")               → Step 1 + instructions
run_sop(..., current_step=1, step_output="...")      → Step 2
run_sop(..., current_step=2, step_output="...")      → Step 3
  ...
run_sop(..., current_step=N, step_output="...")      → Completion

Each response tells the agent to execute the step — not just read it.

Bundled SOPs

Four SOPs ship with the server so new users can try run_sop immediately:

SOP	What it does
`sop_creation_guide`	Step-by-step guide for authoring new SOPs with RFC 2119 requirements
`code_review_process`	Standard code review workflow — prepare, review, address feedback, merge
`employee_onboarding_setup`	IT setup for a new hire — alias, email, hardware selection
`user_onboarding_process`	Provision identity, application access, and welcome package

Storage default: ~/.sop_mcp (seeded from the bundled SOPs on first run). Override with SOP_STORAGE_DIR.

Tools

Tool	Purpose
`list_resources`	Discover available SOPs (built in to every MCP client)
`read_resource`	Read an SOP's full content before executing it
`run_sop`	Execute an SOP step by step
`publish_sop`	Create or update an SOP
`submit_sop_feedback`	Record improvement suggestions

Full parameter reference: docs/mcp-reference.md

Documentation

Audience	Resource
AI tools	`llms.txt` — auto-discovered server description
Users	`skills/sop-mcp-usage/` — how to use
Operators	`skills/sop-mcp-configuration/` — install, configure, hooks
Developers	`CONTRIBUTING.md` — build, test, design decisions
Reference	`docs/mcp-reference.md` — full tool schemas

Development

uv sync              # install dependencies
uv run pytest        # run tests
uv run sop-mcp       # start server locally
uv run python scripts/generate_docs.py  # regenerate docs

License

MIT

Download files

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

Source Distribution

sop_mcp-0.12.2.tar.gz (196.2 kB view details)

Uploaded Jun 13, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sop_mcp-0.12.2-py3-none-any.whl (72.9 kB view details)

Uploaded Jun 13, 2026 Python 3

File details

Details for the file sop_mcp-0.12.2.tar.gz.

File metadata

Download URL: sop_mcp-0.12.2.tar.gz
Upload date: Jun 13, 2026
Size: 196.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for sop_mcp-0.12.2.tar.gz
Algorithm	Hash digest
SHA256	`4e3d650c319673bd638ded30d013455f71dab96fa08559602c20389a136b58db`
MD5	`bd0fc0adc9d9da18df8e580feb19464e`
BLAKE2b-256	`4be1c29d7661ef6813278e10160f67f0d60c8b75464ba0a56804262f68634df3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sop_mcp-0.12.2.tar.gz:

Publisher: publish.yml on ValueArchitectsAI/sop-mcp

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sop_mcp-0.12.2.tar.gz
- Subject digest: 4e3d650c319673bd638ded30d013455f71dab96fa08559602c20389a136b58db
- Sigstore transparency entry: 1808208143
- Sigstore integration time: Jun 13, 2026
Source repository:
- Permalink: ValueArchitectsAI/sop-mcp@bb2df39c43e9102868f5c25bec70820982dcb03e
- Branch / Tag: refs/tags/v0.12.2
- Owner: https://github.com/ValueArchitectsAI
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@bb2df39c43e9102868f5c25bec70820982dcb03e
- Trigger Event: release