Model Context Protocol server

Install

Install the integration and add it to your Mcp workspace.

# Run the MCP server via npx
npx verifiedworkflows-mcp-server

{
  "mcpServers": {
    "verifiedworkflows": {
      "command": "npx",
      "args": ["verifiedworkflows-mcp-server"],
      "env": { "VW_API_KEY": "vw_..." }
    }
  }
}

Submit a task

Add the server to your client config and the agent gains three new tools. It can submit a review, poll its status, and fetch the final result — all structured so the model can reason over the verdict.

from verifiedworkflows import VerifiedWorkflows

client = VerifiedWorkflows(api_key="vw_live_xxx")

task = client.tasks.create(
    content="Body of the generated support reply",
    content_type="text",
    callback_url="https://your-app.example.com/webhook/vw",
)

print(task["id"])  # tsk_live_f8a29

import { VerifiedWorkflows } from "verifiedworkflows";

const client = new VerifiedWorkflows({ apiKey: "vw_live_xxx" });

const task = await client.tasks.create({
  content: "Body of the generated support reply",
  contentType: "text",
  callbackUrl: "https://your-app.example.com/webhook/vw",
});

console.log(task.id);  // tsk_live_f8a29

# Submit any AI output for human review
curl -X POST https://api.verifiedworkflows.com/v1/tasks \
  -H "Authorization: Bearer vw_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Body of the generated support reply",
    "content_type": "text",
    "callback_url": "https://your-app.example.com/webhook/vw"
  }'

Operations

• submit_review — queue content for human review; returns the task id.
• get_review_status — poll the current status of a previously submitted task.
• get_review_result — fetch the reviewer verdict and notes (blocks until ready if requested).
• list_reviews — paginated history of submitted tasks for memory and analytics.

Authentication

Pass your Verified Workflows API key in the VW_API_KEY env var. The server reads it on startup and never logs it.

Transport

The server speaks MCP over stdio (the default for Claude Desktop and Cursor) and over Streamable HTTP for hosted deployments. See the API reference for transport-specific config.