og-fox-mcp

A Model Context Protocol server for og-fox — manage managed OG (social preview) images for every page of your site from any MCP client (Claude Desktop, Cursor, etc.).

Setup

1. Create an API key in the og-fox dashboard under Settings → API keys. Give it the scopes you need (sites:read/write, assignments:read/write, templates:read, coverage:read).
2. Add the server to your MCP client config with the key in the environment:

// claude_desktop_config.json (or your client's MCP config)
{
  "mcpServers": {
    "og-fox": {
      "command": "npx",
      "args": ["-y", "og-fox-mcp"],
      "env": { "OG_FOX_API_KEY": "ogfx_your_key" },
    },
  },
}

OG_FOX_BASE_URL may be set to point at a non-default origin (local dev, etc.).

Tools

| Tool | Scope | Does | | ------------------------- | ------------------- | ---------------------------------------------------------- | | list_sites | sites:read | List websites and their smart URLs | | create_site | sites:write | Add a website; returns its site key + agent prompt | | get_integration_snippet | — | The smart-URL pattern + copy-paste agent prompt for a site | | get_coverage | coverage:read | OG coverage summary (total/covered/missing) for a site | | list_assignments | assignments:read | A site's page → image assignments | | assign_template | assignments:write | Assign a template/screenshot to a page by path | | refresh_page | assignments:write | Invalidate a page's cached image | | list_templates | templates:read | Published templates and their ids |

Example: "Set up og-fox for acme.com and fix every page missing an OG image."

Related

• og-fox — the URL-construction SDK and the og-fox CLI.
• Install guide — framework-by-framework integration.