Connect an MCP client
Add https://api.agentcloud.so/mcp as a remote HTTP MCP server. The endpoint uses stateless Streamable HTTP. An unauthenticated request advertises protected-resource metadata; a compatible client then discovers the authorization server, registers as a public client when needed, and completes an OAuth 2.1 authorization-code flow with PKCE in the browser.
codex mcp add agentcloud --url https://api.agentcloud.so/mcp
codex mcp login agentcloud
Machine-readable discovery
/server.json
MCP server card/mcp/server-card
AI catalog/.well-known/ai-catalog.json
Protected resource/.well-known/oauth-protected-resource
Authorization server/.well-known/oauth-authorization-server
OpenAPI description/openapi.json
API catalog/.well-known/api-catalog
Agent site guide/llms.txt
Named permission scope
mcp:connect allows an authorized MCP client to use the AgentCloud tool surface for the selected workspace. offline_access can be requested when the client needs a refresh token. The protected-resource metadata, authorization-server metadata, and OpenAPI security scheme declare these permissions in machine-readable form so clients do not need to infer access from prose.
Build, run, observe
Upload build-ready source with ios.create_source_upload, then start and monitor a managed Xcode job with ios.build and ios.wait_for_build. Create a Simulator with ios.create, install a successful build or Simulator-compatible app, then use ios.launch, ios.observe, ios.tap, ios.swipe, ios.keyboard, ios.logs, and ios.destroy.
Network helpers cover customer-local Metro and reserved Simulator services through run-scoped tickets and fixed port ranges. The agent never receives a worker shell, a Mac desktop, or the Xcode interface.
Self-serve onboarding
Create a free workspace without a payment card, add the remote MCP URL, and authorize the workspace in the browser. The Free plan includes two lifetime iOS Simulator hours and thirty lifetime managed-build minutes. Read when agents should use AgentCloud, review the product boundary, or compare plans and concurrency.