# AgentCloud developer resources

AgentCloud exposes a hosted iOS Simulator and managed Xcode builds through one remote Streamable HTTP MCP server. Clients authenticate with OAuth 2.1 authorization code plus PKCE and request the named `mcp:connect` permission scope.

## Connect an MCP client

```text
https://api.agentcloud.so/mcp
```

The endpoint supports stateless Streamable HTTP requests. Unauthenticated requests advertise RFC 9728 protected-resource metadata, and the authorization server publishes its endpoints and supported scopes.

- [MCP Registry manifest](https://agentcloud.so/server.json)
- [MCP server card](https://agentcloud.so/mcp/server-card)
- [AI catalog](https://agentcloud.so/.well-known/ai-catalog.json)
- [Protected-resource metadata](https://agentcloud.so/.well-known/oauth-protected-resource)
- [Authorization-server metadata](https://agentcloud.so/.well-known/oauth-authorization-server)
- [OpenAPI description](https://agentcloud.so/openapi.json)
- [API catalog](https://agentcloud.so/.well-known/api-catalog)

## 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 and authorization-server documents are the machine-readable authority for these permissions.

## Tool workflow

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 without exposing a worker shell.

## Onboarding

- [Create a free workspace](https://app.agentcloud.so/signup?plan=free) without a payment card.
- [Read when agents should use AgentCloud](https://agentcloud.so/llms.txt).
- [Review product boundaries](https://agentcloud.so/about).