Codex Replicate Skill

SKILL.md

name	description
replicate-mcp	Configure and validate Replicate MCP connectivity in Codex using REPLICATE_API_TOKEN and the official replicate-mcp server package. Use when setting up Replicate MCP for the first time, reconnecting after auth/config changes, or troubleshooting missing Replicate MCP tools.

Replicate MCP

Use this skill to set up and verify Replicate MCP access in Codex with minimal back-and-forth.

Workflow

1. Confirm prerequisites:
   • node and npx are installed.
   • A valid Replicate API token exists.
2. Prefer CLI-based setup:
   • Export the token in the shell first:
     • export REPLICATE_API_TOKEN="<your_token>"
   • Add the MCP server:
     • codex mcp add replicate --env REPLICATE_API_TOKEN=$REPLICATE_API_TOKEN -- npx -y replicate-mcp@latest
3. Verify connection:
   • Restart Codex session if needed.
   • Check MCP status in chat with /mcp.
   • Run a smoke test prompt such as: show me my replicate account info.
4. If setup fails, use the troubleshooting checklist in references/replicate-mcp-config.md.

Response Pattern

When helping users, keep responses in this order:

1. State the next exact command to run.
2. State what successful output/behavior looks like.
3. If failure occurs, provide one fix at a time.

Guardrails

• Never ask users to paste secrets into chat logs when avoidable.
• Prefer environment variables over hardcoding tokens in files.
• Never claim setup is complete until /mcp shows replicate and a smoke test succeeds.

References

• references/replicate-mcp-config.md for setup commands, manual config, verification, and troubleshooting.