CLI

Install and use the adcom CLI for device-flow auth, hosted MCP inspection, 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 login on its own machine, hand the user a browser URL, wait for approval, and continue without requiring a localhost callback on the same device.

Install

npm install -g adcom

Core commands

adcom login
adcom whoami
adcom logout
adcom mcp inspect-tools
adcom mcp serve

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

adcom login --json

This command:

starts a remote-safe browser approval flow
waits for the user to sign in and approve CLI access
stores a small local session
updates the latest hosted MCP URL
works whether the browser is local or on another machine

The user action is limited to browser approval and any provider connection work in the app.

JSON events

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

Current events:

login_url
login_complete

Manual inspection

If you need to inspect the current identity directly:

adcom whoami

To inspect the hosted tool surface and input schema summaries:

adcom mcp inspect-tools

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 does not add any local convenience tools. It proxies the hosted surface unchanged.

The canonical first read is:

1. Call meta_get_ad_accounts
2. Pick an accessible account_id
3. Call meta_review_account_performance with that explicit account_id

Session state

The CLI stores small local state under ~/.adcom/:

config.json keeps control_plane_url and the latest mcp_url
session.json keeps the session token

adcom logout deletes only session.json and leaves the non-secret endpoint config in place.

Typical flow

adcom login
adcom whoami
adcom mcp inspect-tools
adcom mcp serve

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