Docs

MCP for AI agents

Iconforge hosts a remote MCP server so agents can search the marketplace, pay with account credit, and paste SVG markup into your project — without leaving the chat.

Quick start (2 minutes)

Create an API key at Account → API keys (icm_…).
Optional for paid icons: top up credit (cash balance, not points).
Pick your client below and paste the config (replace the key).

Endpoint: https://iconforge-marketplace.netlify.app/api/mcp

Cursor

Prefer the Cursor Marketplace plugin when published. Until then, drop this into .cursor/mcp.json.

Download mcp.json template
Copy live config
Plugin source: plugins/iconforge/ in the repo (submit via marketplace publish).

Claude Code

AI-ready pack: MCP bridge config + agent instructions.

Live connection config

Cursor — `.cursor/mcp.json`

{
  "mcpServers": {
    "iconforge": {
      "url": "https://iconforge-marketplace.netlify.app/api/mcp",
      "headers": {
        "Authorization": "Bearer icm_YOUR_KEY"
      }
    }
  }
}

Claude Code / Desktop — project `.mcp.json`

Uses mcp-remote to bridge the hosted HTTP server:

{
  "mcpServers": {
    "iconforge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://iconforge-marketplace.netlify.app/api/mcp",
        "--header",
        "Authorization: Bearer icm_YOUR_KEY"
      ]
    }
  }
}

Replace icm_YOUR_KEY. Template downloads under /mcp-setup/ still use YOUR_DOMAIN — swap in https://iconforge-marketplace.netlify.app or copy from the live blocks above.

Tools

search_icons — search by query, tags, free-only, or max price.
get_icon — embeddable SVG when free or owned; otherwise price + buy guidance.
purchase_icon — pay with credit and return the SVG on success.
get_balance — current credit balance and top-up URL.
list_purchases — icons this account already owns.

Example prompts

“Find me a free loading spinner icon and add it to my navbar.”
“Search for arrow icons under $2, show me the top three, then buy the one I pick with credit.”
“List my purchased icons and paste the SVG for the first one.”

Purchases use credit

Agents should confirm with you before calling purchase_icon. Credit is non-withdrawable cash balance topped up on the website. Card checkout is for the browse UI; the MCP path always spends credit.