CLI

Install and use the adcom CLI for agent-first setup, readiness checks, and local MCP bridging.

adcom is the local command line interface for Ad Computer.

It is designed for agent-first operation: a remote Codex or Claude Code session can run setup on its own machine, hand the user a browser URL, wait for approval, and finish the live Meta-first workspace bootstrap without requiring a localhost callback on the same device.

Install

npm install -g adcom

Core commands

adcom setup
adcom status
adcom whoami
adcom accounts list
adcom accounts use <account-id>
adcom doctor
adcom mcp serve

Agent-first setup

For remote, SSH, headless, or agent-driven usage, prefer:

adcom setup --json --no-open --print-url

This command:

starts a remote-safe browser approval flow
waits for the user to sign in and approve CLI access
waits for Meta to be connected in the app
selects a default ad account when one is not configured
creates .adcom/context.yaml when it is missing
validates the workspace and hosted MCP reachability

The user action is limited to browser approval and Meta authentication in the app.

JSON events

adcom setup --json emits JSON lines that agents can react to directly.

Current events:

login_url
login_complete
provider_action_required
provider_default_account_selected
context_initialized
setup_complete

For a one-shot readiness summary without an event stream, use:

adcom status --json

Manual inspection

If you need to inspect the current identity directly:

adcom whoami

Use adcom doctor for a detailed readiness breakdown, including blockers and suggested fixes.

Expose MCP over stdio

adcom mcp serve

Use this when a local MCP client expects a stdio server but you still want the hosted Ad Computer MCP worker to remain the execution layer.

The local bridge also adds one convenience tool on top of the hosted surface:

review_default_account_performance

That tool resolves the configured default Meta account, runs the 7-day review, and returns three deterministic suggested actions without making writes.

Direct hosted MCP clients should call:

meta_review_account_performance

and pass an explicit account_id.

Canonical first review

After setup is healthy, the canonical sequence is:

adcom setup
adcom status
adcom mcp serve

Then ask your agent to call:

review_default_account_performance

Product URLs

Website: https://ad.computer
Docs: https://docs.ad.computer
App: https://app.ad.computer
MCP: https://mcp.ad.computer/mcp

On this page