Skip to main content
Model Context Protocol

MkImage MCP

Connect MkImage to your AI agent to find prompt inspiration and generate or edit images without leaving the conversation.

Streamable HTTP · Endpoint
https://mkimage.ai/api/mcp

Connect in three steps

  1. Create an MCP key

    Sign in with a verified email. In Settings → API Keys, create a key with MCP checked. Copy the one-time value and save it in your client’s secret store as MKIMAGE_API_KEY. Never paste it into a chat or commit it to Git.

  2. Configure your client

    Add the Streamable HTTP server with an Authorization: Bearer header. The examples below read the key from the environment. Make the variable available to your client before starting it, then reconnect. OAuth is not supported.

    Claude Code · .mcp.json
    {
      "mcpServers": {
        "mkimage": {
          "type": "http",
          "url": "https://mkimage.ai/api/mcp",
          "headers": {
            "Authorization": "Bearer ${MKIMAGE_API_KEY}"
          }
        }
      }
    }
    Codex · config.toml
    [mcp_servers.mkimage]
    url = "https://mkimage.ai/api/mcp"
    bearer_token_env_var = "MKIMAGE_API_KEY"
  3. Verify the connection

    Ask your agent to call list_models and list_skills. Discovery does not spend image credits. Once the tools appear, try this prompt:

    Example prompt
    Use MkImage to quote a square studio photo of a blue ceramic cup. Show me the price before generating.

Install the optional Skill

The Skill teaches your agent to quote before generating, prepare image references, and resume tasks safely. It also includes a Node 22+ helper for clients that cannot send custom headers.

Shell
npx skills add MkThingsHQ/mkimage-skills --skill mkimage

Credits, privacy, and retries

  • Submitting an image uses your MkImage credits. One submission creates one image; check the price with quote_image first.
  • Reference uploads and stored outputs are private. Download the saved image using your MCP key or the helper. Delete the key in Settings to revoke it.
  • If a connection drops, query check_generation with the original request ID. Do not start another paid job with a new ID just to recover the result.