# Web Search — MCP server on mcp.ai
> Search the web and read the pages that matter, all from your agent. Returns organic results with title, link and snippet, extracts clean text from any URL and shows how people actually search for a topic. Accepts up to 100 queries in a single call. Hosted by the platform, no credentials, you pay per query.

By: mcp.ai · official
Page: https://mcp.ai/web_search

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_web_search?ms=1788152220000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/web_search/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/web_search/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/web_search/skill.md
Postman collection (v2.1): https://mcp.ai/web_search/postman.json

## Tools
- web_search_read_page(urls: string[], markdown?: boolean) — Lê uma página da web e devolve o texto limpo mais os metadados dela. Use depois de uma busca, para abrir os links que interessaram. Custa o dobro de uma busca por URL. Aceita até 100 URLs por chamada.
- web_search_search(consultas: string[], pais?: string, idioma?: string, limite?: integer, periodo?: string, local?: string, pagina?: integer) — Busca na web e devolve os resultados orgânicos com título, link e trecho, mais a resposta direta e o painel de conhecimento quando existem. Aceita até 100 consultas por chamada.
- web_search_suggest(consultas: string[], pais?: string, idioma?: string) — Devolve as sugestões de autocompletar para um termo. Serve para descobrir como as pessoas realmente pesquisam um assunto, útil em SEO e pesquisa de mercado. Aceita até 100 termos por chamada.

## Example prompts
- "Search "best CRMs 2026", open the top 3 results and compare them"
- "How do people search for open finance? Show me the search suggestions"
- "Read this page and summarize the main points for me"

## Links
Docs: https://mcp.ai/docs/mcps/web_search
Website: https://mcp.ai/mcps/web_search