Sherpa
ReferenceMCP Tools

Initiatives Tools

MCP tools for initiatives operations.

initiative_list

List initiatives with optional filters by status, type, or risk level.

ParameterTypeRequiredDescription
statusstringnoFilter by initiative status
typestringnoFilter by initiative type
riskstringnoFilter by risk level

initiative_get

Get full detail for a single initiative including proposal, plan, activity, seeds, and lifecycle state.

ParameterTypeRequiredDescription
slugstringyesInitiative slug (e.g. 'my-initiative')

initiative_seeds

Get seeds (follow-on ideas) from an integrated initiative's activity log.

ParameterTypeRequiredDescription
slugstringyesInitiative slug

initiative_create

Create a new initiative proposal directory with proposal.md. Returns the file path on success.

ParameterTypeRequiredDescription
slugstringyesInitiative slug (lowercase, hyphens only)
titlestringyesInitiative title
summarystringyes2-3 sentence summary
bodystringyesFull proposal body (markdown)
typestringnoInitiative type
riskstringnoRisk level
targetsarraynoTarget file or directory paths
dependenciesarraynoSlugs of blocking initiatives
agent_idstringnoAgent ID for authority check

initiative_approve

Approve a pending initiative. Enforces governance policy for agent actors. Creates activity.md.

ParameterTypeRequiredDescription
slugstringyesInitiative slug to approve
agent_idstringnoAgent 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.

ParameterTypeRequiredDescription
slugstringyesInitiative slug
statusstringyesNew status
agent_idstringnoAgent ID for authority check

initiative_activity

Append a timestamped entry to an initiative's activity log. Creates activity.md if needed.

ParameterTypeRequiredDescription
slugstringyesInitiative slug
entrystringyesActivity entry text (will be timestamped automatically)
agent_idstringnoAgent ID for authority check

On this page