Skip to content

CONTEXT_FOR_AI_MCP.md

Latest commit

 

History

History
63 lines (47 loc) · 4.26 KB

CONTEXT_FOR_AI_MCP.md

File metadata and controls

63 lines (47 loc) · 4.26 KB
Raw

AgentStack MCP — Capability Map for AI

Purpose: MCP exposes one tool agentstack.execute at https://agentstack.tech/mcp. Use this map to choose the right action and step sequence for a user request. Full action list: GET /mcp/actions.

Broader context: MCP_AND_ECOSYSTEM.md (all channels) · CONTEXT_FOR_AI.md (includes HTTP-only fallback: 8DNA + Protein).

Request shape (agentstack.execute)

{
  "steps": [
    { "id": "step1", "action": "projects.get_projects", "params": {} },
    { "id": "step2", "action": "projects.get_project", "params": { "project_id": { "from": "step1.result.projects[0].id" } } }
  ],
  "context": { "project_id": 2048 },
  "options": { "stopOnError": true }
}
  • Working project (OAuth / user key): Device-code Bearer usually binds to ecosystem project_id=1. Set top-level context.project_id (or arguments.context in tools/call) to the tenant project before session-scoped actions (logic.*, list/write paths that read current_user.project_id). Resource-targeted actions may still pass params.project_id.
  • Reference previous step: In params, use { "from": "stepId.result.path.to.field" } (e.g. "p1.result.project_id").
  • Reference context: Use { "from": "context.project_id" } for request context (project_id, user_id, etc.).
  • Conditional step: Add "if": { "equals": [ { "from": "pay.result.status" }, "success" ] } to run a step only when the condition holds.
  • Project-bound API keys cannot change context.project_id without cross_project (or admin).

User request → action (and typical steps)

User request (example) Domain action(s) Notes
Create a project Projects projects.create_project_anonymous or projects.create_project First step often; then use p1.result.project_id in later steps.
List my projects Projects projects.get_projects params: {} or { "limit": 50 }.
Get one project / project stats Projects projects.get_project, projects.get_stats Need project_id (literal or from previous step).
Give user a 7-day trial Buffs buffs.apply_temporary_effect Params: project_id, user_id, effect id/code, duration.
List active subscriptions / buffs Buffs buffs.list_active_buffs, buffs.get_effective_limits project_id, optional user_id.
Create payment / check status / refund Payments payments.create, payments.get, payments.refund Chain with if on result.status (e.g. completed). Balance: payments.get_balance.
Marketplace / auction / exchange REST (same Core) GET /mcp/actions domain commerce_rest (path hints only) Not valid step.action — use HTTP /api/marketplace/*, /api/exchange/*. See MCP_OVERVIEW.md.
Login / register / get profile Auth auth.quick_auth, auth.create_user, auth.get_profile, auth.update_profile Session/identity.
Create rule / when-then logic Rules / Logic logic.create, rules.create_rules, rules.list_rules Automation, triggers.
Assets / inventory Assets assets.create, assets.list project_id in params.
Schedule task / list tasks Scheduler scheduler.schedule_task, scheduler.list_tasks, scheduler.cancel_task
Analytics / usage / budget Analytics analytics.get_usage, analytics.set_budget, analytics.get_metrics
API keys (project) API Keys projects.get_api_keys, projects.create_api_key, projects.delete_api_key
Webhooks / notifications Other webhooks.create_endpoint, notifications.send_notification See full list in GET /mcp/actions.

Full action list

GET /mcp/actions returns all available action values grouped by domain. Use it to discover exact names (e.g. buffs.apply_temporary_effect, projects.create_project_anonymous) and short summaries.

Related docs

Version: 0.1 — for agentstack.execute. Update when new domains or actions are added; action list is authoritative at GET /mcp/actions.