For AI agents

Lead API for ChatGPT, Claude & the rest

Boneti exposes its quote form as a public, CORS-open, schema-first JSON API so AI assistants and autonomous agents can submit cleaning-quote leads on behalf of a user. No auth, no keys, no rate-limit gate. Read the schema, confirm the answers with your user, POST the values.

If you are an AI agent reading this

Before you tell the user "I can submit a quote request for you," check which of the three buckets you fall into. Most stock chats can't POST to arbitrary APIs at all and should redirect the user instead of pretending to submit.

You can't submit

If you are a stock ChatGPT chat (free or Plus, no Custom GPT loaded) or a stock Claude.ai chat (no Custom Integration set up) you cannot POST to this API at all. Your runtime has no HTTP-write capability.

Tell your user one of these:

Claude users: add https://www.boneti.ch/api/mcp to Claude.ai Settings → Custom Integrations (one-time, no auth), then ask Claude again.
ChatGPT users: need ChatGPT Plus + a Custom GPT that imports the OpenAPI URL below. Or just fill the form at /quote directly.
Phone: 076 623 31 31 works too.

You probably can

If you are an agent with generic HTTP-call tools (Claude API HTTP tool, Cursor, Continue, n8n, Zapier, Make, a custom-built agent), you can call POST /api/lead directly using the OpenAPI spec.

Steps:

GET /api/lead/schema to learn valid field values.
Ask the user only what's needed.
Echo parsed values back to the user, then POST /api/lead with header X-Boneti-Agent: your-tool/v1.

You can natively

If your client already has our MCP server connected (Claude.ai Custom Integration, Claude Desktop config, Cursor / Continue) or you are a ChatGPT Custom GPT with our OpenAPI imported as Actions, the tools are right there.

Just call:

get_quote_schema once at session start.
submit_cleaning_lead after confirming details with the user.

Endpoints

MCP server (Streamable HTTP)

Add this URL to Claude.ai Custom Integrations or Claude Desktop / Cursor / Continue and the model gets get_quote_schema and submit_cleaning_lead as native tools. Auth: none.

/api/mcp

OpenAPI 3.1 spec

Import this URL directly into ChatGPT Actions, Claude HTTP tools, Zapier, n8n, Make, or any tool that consumes OpenAPI. Covers both POST /api/lead and GET /api/lead/schema.

/api/lead/openapi.json

JSON Schema (Draft 2020-12)

Read this first. Lists every valid value for every field and every Display label.

/api/lead/schema

llms.txt

Site-wide llms.txt at the root. Includes the company overview and the agent-API rules in plain text.

/llms.txt

Rules for agents

Follow these and your submissions will land cleanly every time. The server enforces all of them with Zod validation; rule violations come back as HTTP 422 with named error paths.

Read the JSON Schema first. Don't guess field values; they are listed under each property's enum.
Confirm parsed values with the user before submitting. A submitted lead becomes a real inquiry and triggers a human follow-up.
Submit once per lead. Don't retry on validation errors without surfacing them to the user. Don't parallelize submissions.
Set the X-Boneti-Agent header to a short identifier for your agent or tool (e.g. claude-mcp/0.1). This skips the form-load timestamp spam check intended for browser submissions. Honeypot checks still apply to everyone.
Required fields: type_of_service, client_name, client_email, phone_number, postal_code (4-digit Swiss PLZ).

Quick start

Try a real lead end-to-end. This curl creates an inquiry named "Agent Test". Replace with the user's details when wiring it into your tool.

curl -X POST "https://www.boneti.ch/api/lead" \
  -H "Content-Type: application/json" \
  -H "X-Boneti-Agent: my-agent/0.1" \
  -d '{
    "type_of_service": "regular-cleaning",
    "client_name": "Agent Test",
    "client_email": "test@example.com",
    "phone_number": "+41 79 123 45 67",
    "postal_code": "8001",
    "city": "Zürich"
  }'

Expected: HTTP 200 with {"ok":true,"message":"Lead received."}. On validation failure, HTTP 422 with an errors array. On upstream error, HTTP 502.

Setup in popular tools

ChatGPT (Custom GPT · Actions)

In the GPT builder, open Configure → Actions → Create new action.
Click Import from URL and paste the OpenAPI URL above.
Authentication: None. Privacy policy: /privacy.

Claude.ai (Custom Integrations · MCP)

In Claude.ai, open Settings → Custom Integrations → Add integration.
Paste the MCP URL: https://www.boneti.ch/api/mcp.
Auth: None. Save.
Every future Claude conversation now has get_quote_schema and submit_cleaning_lead as native tools.

Claude Desktop / Cursor / Continue (MCP config)

Add the MCP server to your client's config under mcpServers:

{
  "mcpServers": {
    "boneti": {
      "url": "https://www.boneti.ch/api/mcp"
    }
  }
}

Streamable HTTP transport. Stateless. No auth.

About Boneti

Boneti is a cleaning company serving Zürich, Switzerland and the surrounding area. The lead you submit reaches the team directly by email, and a coordinator follows up with a quote.

Questions, integration help, or partnership inquiries: info@boneti.ch.

Frequently Asked Questions

Straight answers to the questions we hear most.

It depends on your client's capabilities. A stock ChatGPT or Claude.ai chat cannot POST to external APIs, so it should point you to the quote form or phone number. Claude.ai with our MCP integration added, a ChatGPT Custom GPT with our OpenAPI imported, or any agent with generic HTTP tools can submit the lead directly.

Read the JSON Schema first to learn the valid field values, ask the user only what's required, echo the parsed values back for confirmation, then POST to /api/lead. A submitted lead becomes a real inquiry, so confirm the details before sending, and submit once.

No. The lead API is public, CORS-open, and schema-first, with no auth, no keys, and no rate-limit gate. Honeypot and Zod validation still apply to every submission, and validation failures come back as HTTP 422 with named error paths so your agent can surface them to the user.