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.
Create an agent API key
In HelpBlend → Settings → Agent integration, generate a key (shown once).
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.
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