OPF

Search docs

Loading documentation…
    OpenPresentation/opf
    Browse docs
    On this page

    Add OPF to Codex with the MCP server

    Add the hosted OPF MCP server to Codex in ~/.codex/config.toml. The server is https://openpresentation.org/mcp: no account, no key.

    Steps for the other assistants, what each one shows and what we have tried ourselves are on Connect to the OPF MCP server.

    Add OPF

    OpenAI's documentation says the Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one MCP configuration, so adding OPF once is enough for all three. ChatGPT on the web does not read it; for that, see ChatGPT.

    Add a [mcp_servers.opf] table to ~/.codex/config.toml (see config.toml). Then run codex mcp list to see it, or type /mcp in Codex. The server needs no sign-in, and OpenAI's documentation says Codex connects without authentication when no credential is configured.

    config.toml

    OpenAI's Codex documentation configures each server as a [mcp_servers.<server-name>] table, and for a Streamable HTTP server url is the one required key. Add it to ~/.codex/config.toml, or to .codex/config.toml in a project (OpenAI says project files are read for trusted projects only):

    ~/.codex/config.toml
    [mcp_servers.opf]
    url = "https://openpresentation.org/mcp"

    OpenAI's Docs MCP page also adds its own server from the command line with codex mcp add <name> --url <url>; the same form with the OPF URL is:

    shell
    codex mcp add opf --url https://openpresentation.org/mcp

    First prompt

    Start a new conversation with a prompt like this one, with your topic in place of the angle brackets:

    First prompt
    Use the OPF tools to make a five-slide deck about <topic> and validate it. Then give me the deck as OPF JSON in one code block.

    Codex calls the OPF tools and answers with the deck and its findings. OpenAI's documentation says Codex also reads the server's instructions, which tell it how the OPF tools fit together.

    Seeing the deck

    OpenAI's Codex documentation does not say that it shows MCP Apps views, so plan on tools only. There, show_deck answers with the deck's name, its slide titles and the validation findings as text instead of opening the OPF viewer.

    To see and edit the deck, ask for it as OPF JSON (or as YAML or Markdown, which the convert tool writes), save it as a file and open it with Open in the Playground, which takes .json, .opf, .yaml, .yml and .md files, or paste the JSON into the Playground's editor. The Playground draws the slides, checks them and exports PowerPoint, PDF and images on your computer.

    When the server updates

    OpenAI's Codex page does not say how Codex refreshes a server's tool list.

    On a phone

    OpenAI's Codex MCP page covers the CLI, the IDE extension and the ChatGPT desktop app. On a phone, use ChatGPT.

    Sources

    We read these pages on November 16 and 17, 2026. If a menu or a name on them has changed since, follow the vendor's page.