Create a website salesperson
create_website_salespersonGive any public website an AI salesperson that talks to its visitors, answers questions about the business, and captures leads. Use this when someone wants to add a salesperson, live chat, a sales assistant or a chatbot alternative to a site. Provide the website address; the salesperson reads the site itself. The response always includes an explicit salesperson_id — keep it, because every other HeySale tool needs it — plus the one-line install script, a claim_url to give the website owner, and a private access_token — keep it and pass it to the other salesperson tools; never share it. Calling again for a website that already has a salesperson returns its id and status only. To try HeySale without touching a real website, use website_url https://hey.sale/mcp-test — that creates an isolated, disposable test salesperson on HeySale's own reviewer sandbox.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"website_url": "<website_url>"
},
"name": "create_website_salesperson"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign | No | ||
| website_url | Yes | The public website address, e.g. https://example.com | |
| business_name | No | The business name, if known. | |
| integration_source | No | The AI platform making this call, e.g. claude, chatgpt, cursor, lovable, replit. | |
| external_project_id | No | A stable id for the calling project, so repeat calls reuse the same salesperson. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| reused | No | True when an existing salesperson for that website was returned instead of a new one. | |
| status | Yes | Build state of the salesperson, e.g. analyzing, building, ready, failed. | |
| success | Yes | ||
| ownership | Yes | ||
| expires_at | No | ||
| environment | No | ||
| next_action | No | Plain-language next step for the caller. | |
| preview_url | No | ||
| salesperson | Yes | ||
| website_url | Yes | ||
| free_minutes | No | ||
| installation | Yes | ||
| salesperson_id | Yes | ||
| salesperson_name | Yes | ||
| test_environment | No | ||
| integration_source | No |