One setup call for widget, AI training, and help center

Create a workspace API key, connect the HelpBlend MCP server in your coding agent, and push a manifest — embed snippet and public help center URL returned ready to install.

Works with
CursorClaude CodeCodexOpenCodeHermesGrokAny MCP client
1

Create an agent API key

In HelpBlend → Settings → Agent integration, generate a key (shown once).

2

Add the MCP server

Point Cursor, Claude Code, Codex, OpenCode, or any MCP client at agent_mcp.py with HELPBLEND_API_KEY and HELPBLEND_BASE_URL.

3

Ask your agent to integrate

Your agent sends bot config, guidelines, sources, widget styling, and help articles — then pastes the embed code on your site.

What gets configured automatically

Same objects you would set up manually in the dashboard — applied idempotently via external_id.

AI bot & training

System prompt, welcome message, knowledge sources (FAQ text or URL crawl), and behavior guidelines.

Chat widget

Brand color, position, greeting, lead capture, and allowed embed origins for CORS.

Help center

Slug, categories, published articles, and public help URL aligned with your bot.

MCP configuration

Add to your agent's MCP settings (stdio):

{
  "mcpServers": {
    "helpblend": {
      "command": "python",
      "args": ["/path/to/helpblend/agent_mcp.py"],
      "env": {
        "HELPBLEND_API_KEY": "hb_...",
        "HELPBLEND_BASE_URL": "https://www.helpblend.com"
      }
    }
  }
}

Sample manifest

Each resource needs a stable external_id for safe re-runs.

{
  "bot": {
    "external_id": "primary",
    "name": "Acme Support",
    "system_prompt": "You are Acme's helpful support agent.",
    "welcome_message": "Hi! How can we help?"
  },
  "guidelines": [
    {
      "external_id": "tone",
      "instruction": "Be concise and friendly."
    }
  ],
  "sources": [
    {
      "external_id": "faq-returns",
      "type": "faq",
      "title": "Returns",
      "content_text": "30-day returns on unused items."
    }
  ],
  "widget": {
    "title": "Acme Support",
    "brand_color": "#7c3aed",
    "allowed_origins": [
      "https://www.acme.com"
    ]
  },
  "help_center": {
    "slug": "acme",
    "enabled": true,
    "categories": [
      {
        "external_id": "getting-started",
        "name": "Getting started"
      }
    ],
    "articles": [
      {
        "external_id": "shipping",
        "category_external_id": "getting-started",
        "title": "Shipping times",
        "content": "We ship within 2 business days.",
        "status": "published"
      }
    ]
  }
}

Ship support automation with your coding agent

14-day trial · Agent keys on every workspace

Get started free