Codex

Codex CLI and the IDE extension read MCP configuration from ~/.codex/config.toml. A trusted project can also provide .codex/config.toml.

Configure remote MCP

Set SOCQ_API_KEY in the environment before starting Codex, then add:

[mcp_servers.socq]
url = "https://api.socq.ai/mcp"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45

For typed YouTube tools:

[mcp_servers.socq_youtube]
url = "https://api.socq.ai/mcp?platforms=youtube"
bearer_token_env_var = "SOCQ_API_KEY"
tool_timeout_sec = 45

Codex supports url for Streamable HTTP MCP servers and bearer_token_env_var for environment-backed bearer authentication. Restart or begin a new Codex session after changing the configuration.

Verify

Ask Codex:

Use SocQ to check my account, then collect the latest 20 comments from this
YouTube video. Wait for the task and return the results as a table:
https://www.youtube.com/watch?v=VIDEO_ID

The connection is working when Codex can call socq_account, submit the collection, and read the returned task with socq_get_task.

Add workflow guidance

Install the socq-social-research Skill to add endpoint selection, billing, polling, pagination, and cross-platform research guidance:

npx skills add socq-ai/socq-devtools

The Skill complements MCP; it does not replace the server. See Agent Skill. See the official Codex config.toml reference for current MCP configuration fields.

Get started

Clients

Workflows

Codex

Codex

Configure remote MCP

Verify

Add workflow guidance

​Codex

​Configure remote MCP

​Verify

​Add workflow guidance

Codex

Configure remote MCP

Verify

Add workflow guidance