Skip to main content

MCP Publishing System — Quick Reference

Publish REST endpoints and workflows as discoverable MCP services in ValkyrAI.

Quick Start​

Publish a REST Controller as MCP Service​

curl -X POST http://localhost:8080/v1/mcp/publish-rest-endpoint \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <JWT_TOKEN>" \
  -d '{
    "controllerPath": "com.valkyrlabs.api.UserController",
    "toolSlug": "user-service",
    "displayName": "User Management Service",
    "category": "UTILITY",
    "apiBaseUrl": "http://localhost:8080",
    "summary": "Manage user accounts and profiles",
    "tags": ["users", "accounts"],
    "authorName": "ValkyrAI Team",
    "autoApprove": true
  }'

Response:

{
  "serviceId": "...",
  "slug": "user-service",
  "status": "PUBLISHED",
  "manifestUrl": "http://localhost:8080/v1/mcp/services/user-service/manifest.yaml",
  "message": "Successfully published ... endpoint(s) as MCP tools"
}

Publish a Workflow as MCP Tool​

curl -X POST http://localhost:8080/v1/mcp/publish-workflow \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <JWT_TOKEN>" \
  -d '{
    "workflowId": "workflow-123",
    "toolSlug": "email-campaign",
    "displayName": "Email Campaign Launcher",
    "category": "AUTOMATION",
    "description": "Send targeted email campaigns to user segments",
    "tags": ["email", "marketing", "automation"]
  }'

List All Published Services​

curl http://localhost:8080/v1/mcp/services

See also: Architecture One Sheet