Let Codex call your phone

Codex with agentring cloud

Sign in, pair your phone from the dashboard, and add the hosted MCP server in ~/.codex/config.toml, on a Codex version that supports Streamable HTTP MCP servers. Put your API key in the AGENTRING_API_KEY environment variable. A call lasts as long as you talk, so raise the tool timeout:

[mcp_servers.agentring]
url = "https://agentring.io/mcp"
bearer_token_env_var = "AGENTRING_API_KEY"
tool_timeout_sec = 1800

Replace ak_… with your API key: the dashboard shows it once when it's created, and you can rotate it any time.

Your agent gets four tools: send_message (a notification you can reply to), get_replies (your replies, waiting up to an hour if needed), call (the phone rings and the voice AI talks with you) and status.

Local MCP server (self-hosted)

Or use the local stdio server from the agentring daemon (self-hosted relay, or the cloud relay URL from your dashboard):

# from a clone of the repo
uv tool install './daemon[voice]'
agentring init --relay <relay-URL> --api-key ak_…
# self-hosted only (on cloud you pair from the dashboard):
agentring pair

codex mcp add agentring -- agentring mcp

Then add tool_timeout_sec = 1800 under [mcp_servers.agentring] in ~/.codex/config.toml. Codex's default tool timeout is 60 seconds, shorter than most calls.

Call Codex from your phone

Tap Call agent in the app and ask by voice. The voice AI asks your agents through consult_agent: each agent in ~/.agentring/agents.yaml is a tool. Run agentring serve --ai on the machine where they live.

agents:
  codex:
    description: Codex in my web app's repo. Code questions, CI status.
    command: [codex, exec, --sandbox, read-only, --ephemeral, --, "{task}"]
    cwd: ~/code/webapp

--sandbox read-only keeps it to answering questions. --sandbox workspace-write lets it edit files under cwd; add --skip-git-repo-check if cwd isn't a git repo.

Try it without a call: agentring agents ask codex "…". If the agent takes more than 20 seconds, the call goes on and the answer arrives when it's ready, or as a message if you've already hung up.

What to ask Codex

• “Upgrade the dependencies and call me if the build breaks.”
• “When the tests pass, message me and wait for my OK before opening the PR.”
• “If you need a product decision, ask me instead of guessing.”

FAQ