Build with Arch Using MCP

Agent Platform exposes its features through a Model Context Protocol (MCP) server. Your AI assistant can connect to the platform and perform platform operations to let you build, evaluate, optimize, debug, and analyze agents. A few common tasks include:

Creating and editing projects, agents, and tools
Running evaluations
Inspecting live sessions and traces
Diagnosing failures

You can perform all these operations from the platform UI as well. However, by using MCP server, you can perform these tasks from within your IDE, command-line, or terminal, without context-switching.

Use the MCP server

The server’s name as available in the clients is arch-agent-platform and its tools are prefixed with platform_ and debug_. These tools are grouped by functional area.

Arch Build

Create and change platform projects, agents, tools, configuration, versions, deployments, and imports.

Tool	Description
`platform_projects`	Manage projects (list, get, create, update, delete)
`platform_agents`	Manage agents (list, get, save_dsl)
`platform_versions`	Manage agent versions (list, create, get, promote, diff)
`platform_deployments`	Manage deployments (list, create, get, retire, rollback)
`platform_tools`	Manage tools (list, get, create, update, delete, test)
`platform_import_export`	Import and export projects
`platform_config`	Manage project and LLM configuration
`platform_workspaces`	List, switch, and inspect active workspaces

Arch Evaluate

Generate eval assets, run eval workflows, and read CI evidence.

Tool	Description
`platform_eval_personas`	Manage and generate eval personas
`platform_eval_scenarios`	Manage and generate eval scenarios
`platform_eval_evaluators`	Manage eval evaluators and templates
`platform_eval_sets`	Manage eval sets
`platform_eval_runs`	Manage eval runs, preflight, cases, and heatmaps
`debug_harness_logs`	Get CI execution logs

Arch Optimize

Validate packages, inspect compiler-visible models, and drive repair loops.

Tool	Description
`platform_validate_package`	Validate a local package and optional import preview
`platform_package_model`	Show compiler-visible agents, tools, constraints, refs, and diagnostics
`debug_lint_abl`	Run ABL repair and design lint checks
`debug_why_transcript_failed`	Correlate transcript symptoms with ABL file/line causes
`debug_diagnose_transcript`	Alias for transcript failure diagnosis

Arch Debug

Connect to live sessions, trace failures, and inspect execution state.

Tool	Description
`platform_connect`	Connect and authenticate to the platform
`debug_list_agents`	List available agents by domain
`debug_load_agent`	Load an agent and create a debug session
`debug_send_message`	Send a message to an agent
`debug_get_current_state`	Inspect agent context, gather progress, flow state
`debug_traces`	Search trace events (type, text, agent, error)
`debug_get_span_tree`	View hierarchical execution flow
`debug_explain_decision`	Explain agent decisions with context
`debug_get_flow_graph`	View state machine graph (JSON or Mermaid)
`debug_get_errors`	Get errors, warnings, and escalations
`debug_list_active_sessions`	List observable sessions
`debug_session`	Subscribe/unsubscribe to session traces

Arch Analyze

Explain documentation, diagnostics, and system health signals.

Tool	Description
`debug_docs`	Get or search ABL documentation
`debug_diagnose`	Diagnose agent config and execution issues
`debug_analyze_session`	Automated session diagnostics

​Use the MCP server

​Arch Build

​Arch Evaluate

​Arch Optimize

​Arch Debug

​Arch Analyze