Skip to content
Ctrl/⌘ K

MCP

MCP domain search tool

Input, output, and behavior generated from the advertised MCP tool contract.

Overview

Search Yep domains with the complete typed public domain-search contract.

Use the typed search tools for web retrieval. Use list_models before BYOK query-builder or agent calls, and configure a provider key at the returned setup_url when requested. When a tool error's structured content includes error.validation, correct every listed RFC 6901 issue before retrying and never repeat an unchanged rejected input.

Input schema

MCP domain search tool input
Name
query
Required
Yes
Type
string
Description
Non-empty search text.
Constraints
min length: 1; max length: 512
Name
limit
Required
No
Type
integer | null
Description
Maximum result count; defaults to 20 and is capped at 100.
Constraints
min: 1; max: 100
Name
select
Required
Yes
Type
SearchResultField[]
Description
Required non-empty response projection.
Constraints
min items: 1
Name
filter
Required
No
Type
string | null
Description
Optional eligibility filter in the public filter language.
Constraints
min length: 1; max length: 65536

Output schema

Returns structured JSON from the shared public API service.

MCP domain search tool output fields
Name
request_id
Required
Yes
Type
string
Description
Public request correlation identifier.
Name
duration_ms
Required
Yes
Type
integer
Description
End-to-end duration in milliseconds.
Name
select
Required
Yes
Type
SearchResultField[]
Description
Echoed normalized projection.
Name
results
Required
Yes
Type
ProjectedDomainResult[]
Description
Ranked projected domains.

Tool errors

Tool execution failures set isError to true. When error.validation is present, correct every RFC 6901 issue before retrying and do not repeat unchanged input.

Request json 
{
  "error": {
    "code": "invalid_request",
    "reason": "malformed_request",
    "message": "invalid request: request body violates the public contract",
    "recovery": null,
    "agent_session_id": null,
    "validation": {
      "contract": "SearchPostRequest",
      "issues": [
        {
          "code": "required",
          "path": "/query",
          "suggestion": "Add the required `query` field."
        }
      ],
      "truncated": false
    }
  },
  "request_id": "00000000-0000-0000-0000-000000000000"
}

Behavior

This tool is read-only, non-destructive, and idempotent.

Commands