Loading...
  • Messages
  • Managed Agents
  • Admin
Search...
⌘K
First steps
OverviewQuickstartPrototype in Console
Define your agent
Agent setupToolsMCP connectorPermission policiesAgent Skills
Configure agent environment
Cloud environment setupCloud sandbox reference
Delegate work to your agent
Start a sessionSession operationsSession event streamSubscribe to webhooksDefine outcomesAuthenticate with vaults
Manage agent context
Access GitHubAttach and download files
Advanced orchestration
Multiagent sessions
Reference
Managed Agents reference
Working with files
Files APIPDF supportImages and vision
Skills
OverviewBest practicesSkills for enterprise
MCP
Remote MCP servers
Claude on cloud platforms
Claude Platform on AWS
Log in
Managed Agents reference
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Managed Agents/Reference

Reference

Event types, self-hosted worker CLI flags, supported MCP server types, rate limits, and branding guidelines for Claude Managed Agents.

This page collects reference material for Claude Managed Agents. For task-oriented guides, follow the links in each section. For the operations on the session resource, see Session operations.

All Managed Agents API requests require the managed-agents-2026-04-01 beta header. The SDK sets the beta header automatically.

Event types

Event type strings follow a {domain}.{action} naming convention. See Session event stream for sending, streaming, and listing events.

Self-hosted worker

These are the ant beta:worker CLI flags for the pre-built worker that drives a self_hosted environment. See Self-hosted sandboxes for setting up the environment, running a worker, and the SDK helper options.

FlagDescription
--environment-idThe environment to poll for work. Also reads from ANTHROPIC_ENVIRONMENT_ID.
--environment-keyAuthenticates the worker with this environment. Also reads from ANTHROPIC_ENVIRONMENT_KEY.
--workdirDirectory where skills are downloaded and tools read and write files. Defaults to . (the current directory); the system default working directory is /workspace.
--on-workScript to call for each claimed work item instead of running tools in-process. Receives session details as environment variables.
--unrestricted-pathsAllow tool calls to access paths outside --workdir.
--max-idleHow long to wait after the session goes idle with an end_turn stop reason before shutting down. Defaults to 60s.
--log-formatLog output format. Use json for structured log ingestion. Defaults to text.

Supported MCP server types

Claude Managed Agents connects to remote MCP servers that expose an HTTP endpoint, or to private MCP servers through MCP tunnels. The server must support the MCP protocol's streamable HTTP transport. See MCP connector for declaring servers on an agent.

For more information on MCP and building MCP servers, see the MCP documentation.

Rate limits

Managed Agents endpoints are rate-limited per organization:

OperationLimit
Create endpoints (such as agents, sessions, and environments)300 requests per minute
Read endpoints (such as retrieve, list, and stream)600 requests per minute

Organization-level spend limits and tier-based rate limits also apply.

Branding guidelines

For partners integrating Claude Managed Agents, use of Claude branding is optional. When referencing Claude in your product:

Allowed:

  • "Claude Agent" (preferred for dropdown menus)
  • "Claude" (when within a menu already labeled "Agents")
  • "{YourAgentName} Powered by Claude" (if you have an existing agent name)

Not permitted:

  • "Claude Code" or "Claude Code Agent"
  • "Claude Cowork" or "Claude Cowork Agent"
  • Claude Code-branded ASCII art or visual elements that mimic Claude Code

Your product should maintain its own branding and not appear to be Claude Code, Claude Cowork, or any other Anthropic product. For questions about branding compliance, contact the Anthropic sales team.

Was this page helpful?

  • Event types
  • Self-hosted worker
  • Supported MCP server types
  • Rate limits
  • Branding guidelines