AgentStack MCP

AgentStack MCP = Work Graph control plane. After session + context.project_id: agents.work_next (mcp_work_loop_v1) -> plan_claim -> plan_execute (CAS/leases). Follow packet.next_action; catalog/discovery.search only if no packet. One-shot CRM/upload may call domain actions directly. Spine: agents.plan_get -> agents.work_next -> agents.plan_claim -> agents.plan_execute. Auth: Connect (G-A174) or Device Code, then auth.get_profile (bootstrap: include_settings false, include_subscriptions false; recipe mcp_session_setup), then context.project_id on every batch. Prompts: agentstack_session_setup, agentstack_execute_budget.

{
  "type": "object",
  "required": [
    "steps"
  ],
  "properties": {
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "action"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Step id in batch."
          },
          "action": {
            "type": "string",
            "description": "Dotted action from /mcp/actions."
          },
          "params": {
            "type": "object",
            "description": "Action params."
          }
        },
        "description": "One catalog action."
      },
      "minItems": 1,
      "description": "Steps; one heavy LLM per sync execute."
    },
    "context": {
      "type": "object",
      "properties": {
        "project_id": {
          "type": "integer",
          "description": "Tenant project id."
        }
      },
      "description": "session.v1; project_id required."
    },
    "options": {
      "type": "object",
      "properties": {
        "goal": {
          "type": "string",
          "description": "Binds the batch to a playbook. A direct call uses execution_intent direct and omits goal. Per-step query must match this text."
        },
        "async": {
          "type": "boolean",
          "description": "Queue; poll discovery.job_status."
        },
        "envelope": {
          "enum": [
            "compact",
            "full"
          ],
          "type": "string",
          "description": "compact (default) | full — ADR MCP_EXECUTE_ENVELOPE_COMPACT_V2"
        },
        "recipe_id": {
          "type": "string",
          "description": "MCP recipe id."
        },
        "stopOnError": {
          "type": "boolean",
          "description": "Stop on first failure."
        },
        "focus_node_id": {
          "type": "string",
          "description": "Work graph node id from agents.work_next packet."
        },
        "continueOnError": {
          "type": "boolean",
          "description": "Continue after failure."
        },
        "idempotency_key": {
          "type": "string",
          "description": "Retry receipt key."
        },
        "semantic_strict": {
          "type": "boolean",
          "description": "Reject batch_semantic_anchor_conflict when anchor set."
        },
        "execution_intent": {
          "enum": [
            "direct",
            "workflow",
            "validate"
          ],
          "type": "string",
          "description": "Batch lane: direct, workflow, or validate."
        },
        "plan_execute_mode": {
          "type": "boolean",
          "description": "Bind plan_execute lane for graph mutations."
        }
      },
      "description": "batch.v1 controls."
    }
  },
  "description": "batch.v1 execute. Direct call: options.execution_intent=direct and no goal. {action, params} is accepted and becomes one step. goal binds a playbook."
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "False on total failure."
    },
    "job_id": {
      "type": "string",
      "description": "Poll id."
    },
    "agent_os": {
      "type": "object",
      "description": "Follow next_step."
    },
    "recovery": {
      "type": "object",
      "description": "Next action when blocked."
    },
    "trace_id": {
      "type": "string",
      "description": "Support trace."
    },
    "error_code": {
      "type": "string",
      "description": "Stable failure code."
    },
    "execution_mode": {
      "type": "string",
      "description": "async when queued."
    },
    "partial_success": {
      "type": "boolean",
      "description": "Some steps failed."
    }
  },
  "description": "result.v1 batch envelope."
}

{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Advertised by the server during the last successful anonymous check.

Create a backend logic rule from natural language description

description

Natural language description of what the rule should do (required)

project_id

Project ID where the rule will be created (required)

Advertised by the server during the last successful anonymous check.

Manage users in a project (add, remove, update roles)

project_id

Project ID (required)

action

Action to perform: add, remove, update_role (required)

user_info

User information (email, user_id, role) (required)

Advertised by the server during the last successful anonymous check.

Create a scheduled task that runs on a schedule

name

Task name (required)

cron

Cron expression (e.g., '0 2 * * *' for daily at 2 AM) (required)

command

Command or tool to execute (required)

Advertised by the server during the last successful anonymous check.

Guide for handling validation errors

tool_name

Name of the tool that failed (required)

validation_errors

List of validation errors (required)

Advertised by the server during the last successful anonymous check.

Execute a logic rule immediately

logic_id

Logic rule ID (UUID) (required)

event_data

Event data to pass to the logic rule

Advertised by the server during the last successful anonymous check.

Use a processor in a logic rule

processor_name

Name of the processor to use (required)

action

Processor action to execute (required)

parameters

Processor-specific parameters (required)

Advertised by the server during the last successful anonymous check.

Execute multiple commands in batch

commands

Array of command objects to execute (required)

Advertised by the server during the last successful anonymous check.

Find any entity by any field using DNA CRUD

target_entity

Entity type (e.g., 'data_users_user', 'data_projects_8dna') (required)

filters

Filter criteria (any field of the entity) (required)

Advertised by the server during the last successful anonymous check.

How to participate in AgentSocial chats and graph via MCP social.* (delegated operator token, polling, contracts).

No arguments advertised.

Advertised by the server during the last successful anonymous check.

System instructions for AgentStack: when to use which tools, projects, users, and resources (agentstack://me, agentstack://projects/{id}). Use tools for actions; use resources for context.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Mandatory session ladder: authenticate, bind context.project_id, then agents.work_next (recipe mcp_work_loop_v1). Catalog search is fallback.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

StackScript TS subset → SSBC via MCP script.* (not Logic JSON rules).

project_id

Tenant project id (required)

Advertised by the server during the last successful anonymous check.

Work Graph skill: agents.work_next, plan_get, claim, when blocked, viewer_urls. Same loop for every MCP protocol version.

project_id

Tenant project id (head or organ) (required)

Advertised by the server during the last successful anonymous check.

Work Graph after session: agents.work_next → follow packet.next_action (often plan_claim → plan_execute when mcp_write). Read keys: work_next without claim. Catalog only if no packet.

project_id

Tenant project id (head or organ) (required)

Advertised by the server during the last successful anonymous check.

Commerce: MCP payments/assets/wallets vs REST marketplace and exchange; canonical action names and typical chains.

use_case

Optional hint: game_economy, saas_billing, marketplace, exchange

Advertised by the server during the last successful anonymous check.

Step-by-step guide for bootstrapping a complete project with economy, RBAC, logic, scheduler, and API keys

use_case

Optional: game, saas, ecommerce, social, backend_api

Advertised by the server during the last successful anonymous check.

Platform owner: grant personal Premium/VIP to a user or Launch/Business/Scale to a project via buffs

plane

personal | project (required)

tier

premium|vip OR starter|basic|pro|enterprise (required)

entity_id

user_id (personal) or project_id (project) (required)

Advertised by the server during the last successful anonymous check.

Tenant project sells subscription SKUs to end users — buff templates, assets, checkout, grant

project_id

Tenant flagship project id (required)

tenant_plan_slug

Tenant SKU slug (e.g. pro_monthly) (required)

Advertised by the server during the last successful anonymous check.

Tenant operator grants subscription buff or inventory to an end user in their project

project_id

Tenant project id (>1) (required)

user_id

Buyer / end-user id (required)

plan_id

Tenant SKU slug (e.g. pro_monthly) (required)

Advertised by the server during the last successful anonymous check.

Add or promote a project member (admin/member/read) — operator and owner paths

project_id

Target project id (required)

user_query

Email or @username to resolve (required)

role

admin | member | read | write

Advertised by the server during the last successful anonymous check.

Deprecated alias — use agentstack_tenant_8dna_supply for tenant 8DNA generation supply.

project_id

Project id with sandbox generations (required)

Advertised by the server during the last successful anonymous check.

Ecosystem /showcase gallery catalog on project_id=1 — read, drift, upsert cards, probe health.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Platform proof showcase (1438–1443): VPS sources sync, hosting.site.build, republish, verify.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Project plan graph (8DNA task_list v2): read, merge, focus run, affinities, F1 promote

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Plan backlog safe cycle: goal-route → plan_process_backlog (preview) → review → plan_apply_proposal (CAS). Telegram/Copilot/MCP parity.

project_id

Project id with orchestrator plan graph (required)

Advertised by the server during the last successful anonymous check.

Inverse orchestrator for external MCP clients: instruction_packet allowed_actions, advance_run_inverse cursor, wave_xix_atoms on agents.* steps

project_id

Tenant project id for work-graph execution (required)

Advertised by the server during the last successful anonymous check.

Master safe cycle: session → preflight → domain mutate in sandbox → verify → diff → gates → promote. All tenant domains via MCP.

project_id

Tenant project id (required)

Advertised by the server during the last successful anonymous check.

Tenant 8DNA supply chain: auto-fork, diff vs prod, gates, promote, realign, deploy boundary.

project_id

Tenant project id (e.g. flagship Unity tenant) (required)

Advertised by the server during the last successful anonymous check.

MCP-first tenant heal: mentor bots, sandbox verify, promote — no local code unless MCP blocked.

project_id

Tenant project id (required)

Advertised by the server during the last successful anonymous check.

Grant OS content plane: catalog, CRM, earning lanes, anchor/W0 — MCP write paths (ecosystem owner).

program_id

Optional grant program_id to scope earning synergy filter

Advertised by the server during the last successful anonymous check.

Business organism MCP: head project, organ children, tariff, command snapshot.

head_project_id

Business head project id (optional for bootstrap)

Advertised by the server during the last successful anonymous check.

End-to-end tenant business assistant via MCP recipe (head, CRM organ, operator, Telegram).

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Quick reference for 12 real business scenarios with tool synergies and cross-flow patterns

scenario

Optional: bootstrap, saas_trial, game_economy, loyalty, ecommerce, automation, content, social, b2b, campaign, usage_billing, matchmaking

Advertised by the server during the last successful anonymous check.

Guide for creating and using API keys safely with service_caps restrictions

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Paradigm shift: buffs as timers, users as containers, projects as shared state

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Sync 60s mcp_batch vs heavy LLM steps; async jobs and discovery.job_status

No arguments advertised.

Advertised by the server during the last successful anonymous check.

How to edit text and collections: prefer search_replace / unified_diff; merge lists by key; never paste a truncated window as the full body

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Cross-surface text edit ladder: search_replace and fuzzy unified_diff (same engine as App Studio). Prefer over full-body replace.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Read-only MCP bootstrap with continueOnError; omit apikeys.list without api_keys cap

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Complete AI guide for using the built-in messenger and social network via MCP (social.chat.*, social.channels.*, social.friends.*, social.public.*)

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Unified Channel Plane: enroll delivery sources, category prefs, notifications.deliver, and channels.* MCP tools

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Agents Fleet: configure, enqueue, orchestrate.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Integration Hub: recipes, connections, webhooks, diagnostics.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

CRM workspace: contacts, deals, pipeline, import.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Hosted vertical SaaS: EDITFLOW wire, bootstrap, tenant UI facades.

project_id

Flagship tenant project id (required)

Advertised by the server during the last successful anonymous check.

Key2Unity auth portal /s/1444/key2unity/: persona, bucket, dual bot identity, publish.

project_id

Unity mentor flagship (1444) (required)

Advertised by the server during the last successful anonymous check.

Hosted shop: create products, list them for sale, publish /s/, take checkout.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Change an already published /s/ site with snapshot and release promote (not quickstart).

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Publish a single HTML landing page to hosted /s/ (agent recipe).

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Build static or node_vite site from bucket workspace sources.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Per-bucket git journal: init, push dev/main, poll builds, preview and prod URLs.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Resolve deploy surface (site vs app vs shop vs service) before mutating.

project_id

Project id (required)

intent

Operator goal text

Advertised by the server during the last successful anonymous check.

Upload pre-built React/Vite dist to /s/ (no npm in MCP).

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Edit one UTF-8 file in hosted bucket working tree via patch.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Bots Fleet studio: templates, brain, handoff, broadcast.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Agent-to-agent messaging on bot message bus (@handle, webhook push, inbox poll).

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Project support staff inbox and AI binding.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Knowledge platform: config leaf, KB ingest, playground (heavy), heal index.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Tune mentor prompt → playground → promote (UF_KNOWLEDGE_PROMPT_TUNE).

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Safety playbook overlay → safety.evaluate → promote.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Pick a context lane, ingest task docs, and tune caps in 8DNA.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Platform Compass playbooks: guidance.list, match_playbook, start_path, complete_step.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Headless React app studio. Same verbs for an external agent and the project orchestrator.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Project AI orchestrator — workspace vs messenger vs bots, generation F1, RAG memory.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

KB vs episodic memory disambiguation for orchestrator agents.

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Project wallet treasury vs personal wallets vs AgentNet.

project_id

Project id (required)

Advertised by the server during the last successful anonymous check.

Build games with player management, game logic, and monetization

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Build SaaS with trials, subscriptions, and usage tracking

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Build online stores with products, cart, and payments

No arguments advertised.

Advertised by the server during the last successful anonymous check.

AgentSocial: messenger, friends graph, PAS, public index via social.* MCP actions

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Build REST APIs with CRUD, webhooks, and automation

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Bootstrap complete projects: economy, RBAC, logic rules battery, scheduler, FAP, API keys, RAG

No arguments advertised.

Advertised by the server during the last successful anonymous check.

Project config, storage, hosting, knowledge, CRM, agents, bots, integrations, logic, generation, release

agentstack://planes

MIME type: text/plain

{
  "audience": [
    "assistant"
  ],
  "priority": 0.9
}

Advertised by the server during the last successful anonymous check.

Lightweight action totals, catalog etag, registry dimensions

agentstack://catalog/summary

MIME type: application/json

{
  "audience": [
    "assistant"
  ],
  "priority": 0.9
}

Advertised by the server during the last successful anonymous check.

Mandatory auth → project → context.project_id order (instruction plane SoT)

agentstack://instructions/session

MIME type: text/markdown

{
  "audience": [
    "assistant"
  ],
  "priority": 1
}

Advertised by the server during the last successful anonymous check.

Closed-loop plan graph spine — work_next before catalog shopping

agentstack://instructions/work-graph

MIME type: text/plain

{
  "audience": [
    "assistant"
  ],
  "priority": 1
}

Advertised by the server during the last successful anonymous check.

Tenant project JSON config slice (requires membership)

agentstack://projects/{project_id}

MIME type: application/json

Advertised by the server during the last successful anonymous check.

Project membership row for one user (requires membership)

agentstack://projects/{project_id}/users/{user_id}

MIME type: application/json