Skip to content
Ctrl/⌘ K

MCP

MCP search tool

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

Overview

Search Yep with the complete typed public POST search contract and return projected ranked results.

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 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 at the product boundary.
Constraints
min: 1; max: 50
Name
lang
Required
No
Type
string | null
Description
Optional two-letter lowercase language code.
Constraints
pattern: ^[a-z]{2}$
Name
coverage
Required
No
Type
SearchCoverage | null
Description
Search breadth; omission preserves balanced search.
Constraints
Name
ranking
Required
No
Type
SearchRanking | null
Description
Ranking focus; omission preserves balanced search.
Constraints
Name
select
Required
No
Type
SearchResultField[]
Description
Response projection; omission selects the stable summary fields.
Constraints
default: url,title,description,language; 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
Name
max_results_per_domain
Required
No
Type
integer | null
Description
Optional maximum number of results from one registrable domain.
Constraints
min: 1; max: 10

Output schema

Returns structured JSON from the shared public API service.

MCP 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
ProjectedPageResult[]
Description
Ranked projected results.

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