Skip to content
famasi.ai

Codex

Use provider tools in Codex with a local skill and MCP server connection. Codex integration gives you:

  • Skill file — Famasi provider instructions at .famasi/skills/codex/famasi-provider/SKILL.md
  • AGENTS.md — Codex-level agent directive (created or appended)
  • MCP server — Connection to https://mcp.famasi.ai/mcp

Install

Terminal window
npx @famasi/agents@latest install codex

Files created

.mcp.json                                           # MCP server config
.famasi/skills/codex/famasi-provider/SKILL.md       # Skill instructions
AGENTS.md                                            # Agent directive (upserted)

If AGENTS.md already exists, the installer appends a ## Famasi Provider section. If not, it creates one:

## Famasi Provider
- Use the local skill at `.famasi/skills/codex/famasi-provider/SKILL.md`.
- Use the `famasi-provider` MCP server before guessing endpoint shapes.
- Run `npx @famasi/agents doctor` when the install state is unclear.

The installer only appends if ## Famasi Provider isn’t already present — safe to run multiple times.

Authenticate

Link provider:

Terminal window
npx @famasi/agents@latest link provider --provider-id YOUR_PROVIDER_ID

API key:

Terminal window
export FAMASI_PROVIDER_API_KEY=pk_live_...

Full authentication details →

Usage

Once installed and linked, use natural language in Codex:

"Search the formulary for metformin"
"Show my wallet balance"
"List orders from this week"
"Create a customer with phone +2348012345678"

Codex reads the skill file and uses the MCP server for all API calls.

Troubleshooting

“Skill not found”

Terminal window
npx @famasi/agents@latest doctor

Check that .famasi/skills/codex/famasi-provider/SKILL.md exists.

“MCP server not responding”

  • Verify .mcp.json exists and points to https://mcp.famasi.ai/mcp
  • Check your API key is set

“AGENTS.md conflict”

  • The installer only appends if ## Famasi Provider isn’t already present
  • Safe to run multiple times

More troubleshooting →