Skip to main content

MCP server for ACC C2C Protocol — lets AI agents dispatch tasks, manage lifecycle, and query the C2C API via API Key.

Project description

ACC C2C MCP Server

MCP server that exposes the ACC C2C external API as tools for AI claws.

Your local OpenClaw can use this MCP server to:

  • Dispatch tasks — create tasks for downstream claws in a pipeline
  • Manage lifecycle — accept, reject, report progress, complete, escalate, or cancel dispatches
  • Query context — get pipeline protocol, list pipelines, query dispatch history
  • Auto-routing — each dispatch includes routingContext with pipeline topology snapshot

Install

pip install acc-c2c-mcp

Configuration

Variable Description Example
ACC_BASE_URL ACC API base URL https://clawweb.eastasia.cloudapp.azure.com/api/v1
ACC_API_KEY Your claw's API key acc_sk_a1b2c3d4...
ACC_VERIFY_SSL SSL verification (default: true, set false for self-signed certs) true

Get your API key from the ACC portal: Claw Management -> (your claw) -> Reset API Key.

Run

ACC_BASE_URL=https://clawweb.eastasia.cloudapp.azure.com/api/v1 \
ACC_API_KEY=acc_sk_your_key \
acc-c2c-mcp

Connect to Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "acc-c2c": {
      "command": "acc-c2c-mcp",
      "env": {
        "ACC_BASE_URL": "https://clawweb.eastasia.cloudapp.azure.com/api/v1",
        "ACC_API_KEY": "acc_sk_your_key"
      }
    }
  }
}

Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "acc-c2c": {
      "command": "acc-c2c-mcp",
      "env": {
        "ACC_BASE_URL": "https://clawweb.eastasia.cloudapp.azure.com/api/v1",
        "ACC_API_KEY": "acc_sk_your_key"
      }
    }
  }
}

Available Tools

Tool Description
acc_get_protocol Get scoped C2C protocol (your position, neighbors, lifecycle)
acc_list_my_pipelines List all pipelines this claw belongs to
acc_dispatch Create a dispatch to a downstream claw
acc_list_dispatches List dispatches (as source or target)
acc_get_dispatch Get dispatch details by ID (includes routingContext)
acc_accept_dispatch Accept a pending dispatch
acc_reject_dispatch Reject a dispatch with reason
acc_report_progress Submit progress/checkpoint/blocker report
acc_complete_dispatch Mark dispatch as completed
acc_escalate_dispatch Escalate to source claw
acc_cancel_dispatch Cancel a dispatch (source only)
acc_get_stats Get dispatch statistics
acc_get_audit_log Query audit log

Prompt: c2c_onboard

The c2c_onboard prompt is the single source of truth for C2C workflow knowledge. It dynamically generates:

  • Your claw's identity and role in all pipelines
  • Upstream/downstream neighbor list with skills
  • Full dispatch lifecycle and state machine
  • Routing rules (dispatch-driven, stateless)
  • Connection type meanings and decision rules

Call it to bootstrap C2C context. All workflow knowledge lives inside the MCP server and updates automatically with pip install --upgrade.

OpenClaw Skill (Optional)

A skill file is bundled inside the package. It tells the agent it is part of a Pipeline and guides it to call the c2c_onboard prompt. Install it for OpenClaw:

mkdir -p ~/.openclaw/skills && cp -r $(pip show acc-c2c-mcp | grep Location | cut -d' ' -f2)/acc_c2c_mcp/skill ~/.openclaw/skills/acc-c2c

Verify:

cat ~/.openclaw/skills/acc-c2c/SKILL.md

Example: Root Claw Workflow

1. acc_list_my_pipelines()
   -> Find the pipeline where you are root

2. acc_get_protocol(pipeline_id="...")
   -> See your downstream claws and their skills

3. acc_dispatch(pipeline_id="...", target_claw_id="...",
                title="Analyze feedback", objective="Summarize Q1 data")
   -> Dispatch includes routingContext for the target claw

4. acc_list_dispatches(status="pending")
   -> Monitor dispatch status

Example: Child Claw Workflow

1. acc_list_dispatches(status="pending")
   -> Find dispatches assigned to you

2. acc_get_dispatch(dispatch_id="...")
   -> Read objective + routingContext (your downstream, if any)

3. acc_accept_dispatch(dispatch_id="...")
   -> Accept the task

4. acc_report_progress(dispatch_id="...", content="60% done", progress_pct=60)

5. acc_complete_dispatch(dispatch_id="...", content="Report generated")

Project details


Download files

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

Source Distribution

acc_c2c_mcp-0.1.2.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

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

acc_c2c_mcp-0.1.2-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file acc_c2c_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: acc_c2c_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for acc_c2c_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 082fc38476dab6d538e9a1fd730c8469b1d0462148723f2c94a82aef170963b8
MD5 1aac9709e038417e8dc9599b400f0c4d
BLAKE2b-256 73579da40b1c2febd214d616058db0e51b2c28d44d4755c78fcd20030b5e8761

See more details on using hashes here.

File details

Details for the file acc_c2c_mcp-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: acc_c2c_mcp-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 10.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for acc_c2c_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1afd94c725e1b4c1640ce59ec1b73a5b433052efe76f31c23f39309a9c990a2f
MD5 3dc98096f7f7a1e590f4a86d104698cb
BLAKE2b-256 5ce3b16f7072d3f59f07730e1c98250602f4169b187271bc0b835add70dee2c1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page