{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_x9eat79m5wet","handle":"mcp-acp","url":"https://wellknown.network/agents/mcp-acp","links":{"self":"https://wellknown.network/agents/mcp-acp/record.json","html":"https://wellknown.network/agents/mcp-acp","markdown":"https://wellknown.network/agents/mcp-acp/record.md","api":"https://wellknown.network/api/v1/agents/mcp-acp","status":"https://wellknown.network/api/v1/agents/mcp-acp/status","claim":"https://wellknown.network/agents/mcp-acp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-acp/claim.json","badge":"https://wellknown.network/agents/mcp-acp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-acp/history","tools":"https://wellknown.network/api/v1/agents/mcp-acp/tools"},"ard":{"identifier":"urn:air::server:mcp-acp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-acp","summary":"MCP server for Ambient Code Platform (ACP) session management - list, delete, debug, and manage AgenticSession resources via the public API","description":"# MCP ACP Server\n\nA Model Context Protocol (MCP) server for managing Ambient Code Platform (ACP) sessions via the public-api gateway.\n\n---\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [Features](#features)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n- [Tool Reference](#tool-reference)\n- [Troubleshooting](#troubleshooting)\n- [Architecture](#architecture)\n- [Security](#security)\n- [Development](#development)\n- [Roadmap](#roadmap)\n- [Contributing](#contributing)\n- [Status](#status)\n\n---\n\n## Quick Start\n\n```bash\n# Install\ngit clone https://github.com/ambient-code/mcp\ncd mcp\npip install .    # installs the 'mcp-acp' command\n\n# Configure\nmkdir -p ~/.config/acp\ncat > ~/.config/acp/clusters.yaml <<EOF\nclusters:\n  my-cluster:\n    server: https://public-api-ambient.apps.your-cluster.example.com\n    token: your-bearer-token-here\n    default_project: my-workspace\ndefault_cluster: my-cluster\nEOF\nchmod 600 ~/.config/acp/clusters.yaml\n```\n\nThen add to your MCP client ([Claude Desktop](#claude-desktop), [Claude Code](#claude-code-cli), or [uvx](#using-uvx)) and try:\n\n```\nList my ACP sessions\n```\n\n---\n\n## Features\n\n### Session Management\n\n| Tool | Description |\n|------|-------------|\n| `acp_list_sessions` | List/filter sessions by status, age, with sorting and limits |\n| `acp_get_session` | Get detailed session information by ID |\n| `acp_create_session` | Create sessions with custom prompts, repos, model selection, and timeout |\n| `acp_create_session_from_template` | Create sessions from predefined templates (triage/bugfix/feature/exploration) |\n| `acp_delete_session` | Delete sessions with dry-run preview |\n| `acp_restart_session` | Restart a stopped session |\n| `acp_clone_session` | Clone an existing session's configuration into a new session |\n| `acp_update_session` | Update session metadata (display name, timeout) |\n\n### Observability\n\n| Tool | Description |\n|------|-------------|\n| `acp_get_session_logs` | Retrieve container lo…","publisher":{"name":"Ambient Code Team","url":null},"homepage":null,"repository":null,"version":"0.4.0","license":null,"protocols":["mcp"],"tags":["mcp","acp","ambient","ambient-code-platform","agentic-session","agenticsession","public-api"],"pricing":null,"endpoints":[{"url":"pypi:mcp-acp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":0.825,"provenance":"derived"},{"slug":"code.debugging","name":"Debugging","confidence":0.779,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-acp","registry":"pypi","observedAt":"2026-11-03T11:24:56.402Z","publishedAt":"2026-04-01T21:33:05.332078Z","latestVersion":"0.4.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-acp","url":"https://pypi.org/project/mcp-acp/","firstSeenAt":"2026-09-10T00:23:10.451Z","fetchedAt":"2026-11-03T11:24:22.825Z","normalizedAt":"2026-11-03T11:24:22.825Z"}]},"firstSeenAt":"2026-09-10T00:23:10.451Z","updatedAt":"2026-11-03T11:24:56.402Z"}