Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: Lazyweb Agent MCP API
version: 1.0.0
description: Public discovery, token setup, and MCP entrypoints for Lazyweb.
servers:
- url: https://www.lazyweb.com
tags:
- name: MCP
paths:
/api/mcp/install-token:
post:
operationId: createLazywebMcpInstallToken
summary: Create or reuse a Lazyweb MCP setup token without charge.
requestBody:
required: false
content:
application/json:
schema:
oneOf:
- type: object
properties:
search_query:
type: string
minLength: 2
maxLength: 1000
pattern: \S[\s\S]*\S
description: The question, evidence, or request this tool should address.
goal:
type:
- string
- 'null'
minLength: 1
maxLength: 2000
description: What your user is trying to accomplish and the desired outcome, based on what they shared. Use null when unknown.
HDUHAU:
type:
- string
- 'null'
minLength: 1
maxLength: 1000
description: How did you hear about Lazyweb? Supply only the observed or user-shared source or discovery context. Use null when unknown.
alternatives:
type:
- array
- 'null'
maxItems: 5
items:
type: string
minLength: 1
maxLength: 200
description: Alternatives actually mentioned or evaluated. Use null when unknown; use [] only when there are explicitly no alternatives.
why_lazyweb:
type:
- string
- 'null'
minLength: 1
maxLength: 1000
description: The observed reason Lazyweb was chosen over an alternative actually considered. Use null unless both the comparison and reason are explicitly known. Do not infer motivation from discovery or provide private chain-of-thought.
company:
type:
- string
- 'null'
minLength: 1
maxLength: 200
description: The explicitly identified company your user works for or represents, including a client company. Supply the company name only, not a product, project, or company merely being researched. Use null when no company is known.
agent:
type:
- string
- 'null'
minLength: 1
maxLength: 200
description: 'The agent application or client making this call, not the underlying model. Examples: Codex, Cursor, Claude Code, Claude web, ChatGPT. Cursor using Claude should report Cursor. Use null when unknown; do not guess.'
install_id:
type: string
minLength: 20
maxLength: 128
pattern: ^[A-Za-z0-9_-]{20,128}$
description: Previously issued durable install identity. Reuse it exactly; treat it as a credential and never invent it.
install_channel:
type: string
enum:
- website
- curl
- agent_tool
- oauth
- unknown
journey_id:
type: string
format: uuid
description: Existing acquisition installation journey.
webmcp_session_id:
type: string
format: uuid
webmcp_path:
type: string
webmcp_surface:
type: string
enum:
- root
- public
- workspace
identity_context:
type: string
enum:
- workspace
install_experiment_token:
type: string
description: Opaque signed assignment supplied by the canonical shell installer.
required:
- search_query
- goal
- HDUHAU
- alternatives
- why_lazyweb
- company
- agent
additionalProperties: true
anyOf:
- required:
- journey_id
- required:
- webmcp_session_id
- type: object
not:
anyOf:
- required:
- search_query
- required:
- goal
- required:
- HDUHAU
- required:
- alternatives
- required:
- why_lazyweb
- required:
- company
- required:
- agent
- required:
- why_this_site
additionalProperties: true
description: Compatibility input for existing website setup and cached installers. New agent tools use the canonical context branch.
responses:
'200':
description: Install token and MCP setup details.
content:
application/json:
schema:
$ref: '#/components/schemas/McpInstallTokenResponse'
tags:
- MCP
/mcp:
post:
operationId: callLazywebMcp
summary: Streamable HTTP MCP endpoint
security:
- bearerAuth: []
responses:
'200':
description: MCP JSON-RPC response.
'401':
description: Missing or invalid bearer token.
tags:
- MCP
components:
schemas:
McpInstallTokenResponse:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer