1.2.1npm · openai-websearch-mcp · current release
Observed 2026-08-22T22:49:44.150Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.
{
"tools": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
web_search_chat_completionPerform a web search using OpenAI's Chat Completions API with search-enabled modelsInput schema{
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"gpt-4o-search-preview",
"gpt-4o-mini-search-preview"
],
"description": "Model to use for web search"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"user",
"assistant",
"system",
"developer"
]
},
"content": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"additionalProperties": false
},
"description": "Conversation messages"
},
"web_search_options": {
"type": "object",
"properties": {
"user_location": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "approximate"
},
"approximate": {
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two-letter ISO country code (e.g., 'US')"
},
"city": {
"type": "string",
"description": "City name (e.g., 'San Francisco')"
},
"region": {
"type": "string",
"description": "Region or state (e.g., 'California')"
},
"timezone": {
"type": "string",
"description": "IANA timezone (e.g., 'America/Los_Angeles')"
}
},
"additionalProperties": false
}
},
"required": [
"type",
"approximate"
],
"additionalProperties": false,
"description": "Optional user location to refine search results"
},
"search_context_size": {
"type": "string",
"enum": [
"low",
"medium",
"high"
],
"description": "Amount of context retrieved from the web"
}
},
"additionalProperties": false,
"description": "Configuration options for web search"
}
},
"required": [
"model",
"messages"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |
web_search_responsesPerform a web search using OpenAI's Responses API with web_search_preview toolInput schema{
"type": "object",
"properties": {
"model": {
"type": "string",
"enum": [
"gpt-4o"
],
"description": "Model to use for response generation"
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"web_search_preview",
"web_search_preview_2025_03_11"
]
},
"user_location": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "approximate"
},
"approximate": {
"type": "object",
"properties": {
"country": {
"type": "string",
"minLength": 2,
"maxLength": 2,
"description": "Two-letter ISO country code (e.g., 'US')"
},
"city": {
"type": "string",
"description": "City name (e.g., 'San Francisco')"
},
"region": {
"type": "string",
"description": "Region or state (e.g., 'California')"
},
"timezone": {
"type": "string",
"description": "IANA timezone (e.g., 'America/Los_Angeles')"
}
},
"additionalProperties": false
}
},
"required": [
"type",
"approximate"
],
"additionalProperties": false,
"description": "Optional user location to refine search results"
},
"search_context_size": {
"type": "string",
"enum": [
"low",
"medium",
"high"
],
"description": "Amount of context retrieved from the web"
}
},
"required": [
"type"
],
"additionalProperties": false
},
"description": "Tools the model can use"
},
"input": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"type": "string",
"enum": [
"user",
"assistant",
"system"
]
},
"content": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"additionalProperties": false
}
}
],
"description": "Conversation messages (will be converted to input/instructions format)"
}
},
"required": [
"model",
"tools",
"input"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
} | — | — · — | — |