Skip to content

feat: agent tool aliasing — expose /agents/run and /agents/bootstrap as MCP tools #24

@stackbilt-admin

Description

@stackbilt-admin

Context

The agents vertical shipped in tarotscript (#125-130). Two new worker endpoints are live:

  • POST /agents/run — C-Level agent reasoning (role, intention, context, pain signals → structured analysis with dignity tensions and confidence scoring)
  • POST /agents/bootstrap — domain deck research (role, domain, internal signals → bootstrap methodology + card candidates for new agent decks)

The agent-response contract is signed at @stackbilt/contracts/agent-response and defines all request/response schemas.

What's needed

MCP tool definitions wrapping the agent endpoints

agent_consult

  • Wraps POST /agents/run
  • Input: role (string — e.g. "cto"), intention (string), context (object — org size, stage, constraints), painSignals (string[] — raw user frustrations)
  • Output: AgentRunResult — stance, domain lens, constraint, action, confidence, dignity tensions, oracle synthesis

agent_bootstrap

  • Wraps POST /agents/bootstrap
  • Input: role (string), domain (string — the knowledge domain to research), internalSignals (string[] — what the org already knows)
  • Output: bootstrap methodology + card candidates (category breakdown, trait suggestions, governance guardrails)

Schema sourcing

All request and response types are defined in @stackbilt/contracts/agent-response. The MCP tool input/output schemas should be derived from these contracts to stay in sync — no hand-rolled duplicates.

References

  • tarotscript commits: 257a6be (agents vertical), 952239e (deck-bootstrap-cast)
  • tarotscript issues: #125-130

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions