ReferenceMCP Tools
Initiatives Tools
MCP tools for initiatives operations.
initiative_list
List initiatives with optional filters by status, type, or risk level.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | no | Filter by initiative status |
type | string | no | Filter by initiative type |
risk | string | no | Filter by risk level |
initiative_get
Get full detail for a single initiative including proposal, plan, activity, seeds, and lifecycle state.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug (e.g. 'my-initiative') |
initiative_seeds
Get seeds (follow-on ideas) from an integrated initiative's activity log.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug |
initiative_create
Create a new initiative proposal directory with proposal.md. Returns the file path on success.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug (lowercase, hyphens only) |
title | string | yes | Initiative title |
summary | string | yes | 2-3 sentence summary |
body | string | yes | Full proposal body (markdown) |
type | string | no | Initiative type |
risk | string | no | Risk level |
targets | array | no | Target file or directory paths |
dependencies | array | no | Slugs of blocking initiatives |
agent_id | string | no | Agent ID for authority check |
initiative_approve
Approve a pending initiative. Enforces governance policy for agent actors. Creates activity.md.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug to approve |
agent_id | string | no | Agent ID — if provided, actor is 'agent' and governance policy applies |
initiative_update_status
Change initiative status with lifecycle transition validation. Only valid transitions are allowed.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug |
status | string | yes | New status |
agent_id | string | no | Agent ID for authority check |
initiative_activity
Append a timestamped entry to an initiative's activity log. Creates activity.md if needed.
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | yes | Initiative slug |
entry | string | yes | Activity entry text (will be timestamped automatically) |
agent_id | string | no | Agent ID for authority check |