Search the web for current information, news, facts or any topic. Returns ranked results with titles, URLs, and snippets. Use this tool when the agent needs up-to-date information not available in its training data.
Input Parameters
Parameter
Type
Description
queryrequired
string
The search query. Be specific for better results.
num_resultsoptional
integer
Number of results to return. Default: 5, max: 10.
languageoptional
string
Language code for results: 'en', 'es', 'fr', etc. Default: "en".
safe_searchoptional
boolean
Enable safe search filtering. Default: true.
Output Fields
Field
Type
Description
results
array
List of search results, each with title, url, snippet, and date.
total_results
integer
Estimated total number of results found.
query
string
The query that was actually executed (may be normalized).
Example
// Input
{
"query": "PascalAI language features 2026",
"num_results": 3,
"language": "en"
}
// Output
{
"results": [
{
"title": "PascalAI v1.0 Released",
"url": "https://pascalai.org/blog/v1",
"snippet": "The AI-native Pascal language now supports...",
"date": "2026-03-01"
},
{
"title": "PascalAI Language Specification",
"url": "https://docs.pascalai.org/spec",
"snippet": "Full language specification covering agents, flows..."
}
],
"total_results": 1840,
"query": "PascalAI language features 2026"
}
Install & Discovery
Install
ppm install mcp-web-search
Get JSON Schema
GET /v1/packages/mcp-web-search/1.0.0/schema
Discover by keyword
GET /v1/mcp/discover?q=web+search
Discovery hint: Use this tool when the agent needs current information not in its training data — news, prices, recent events, live documentation.