news_search

Pack: brave-search · Endpoint: https://gateway.pipeworx.io/brave-search/mcp

News-specific search with publication metadata. Returns title, URL, source, age, snippet, and breaking-news flag.

Parameters

NameTypeRequiredDescription
qstringyesSearch query
countnumbernoResults (1-20, default 10)
offsetnumberno0-9 page offset
countrystringno2-letter country code
search_langstringno2-letter language
freshnessstringnopd | pw | pm | py

Example call

curl -X POST https://gateway.pipeworx.io/brave-search/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"news_search","arguments":{}}}'

Response shape

Always returns: query, returned, results

FieldTypeDescription
querystringThe search query
returnedintegerNumber of news results returned
resultsarrayArray of news search results
Full JSON Schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query"
    },
    "returned": {
      "type": "integer",
      "description": "Number of news results returned"
    },
    "results": {
      "type": "array",
      "description": "Array of news search results",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "News article title"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "News article URL"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Article snippet/description"
          },
          "age": {
            "type": [
              "string",
              "null"
            ],
            "description": "Age of the article"
          },
          "page_age": {
            "type": [
              "string",
              "null"
            ],
            "description": "Age of the page"
          },
          "breaking": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether article is breaking news"
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "News source hostname"
          },
          "thumbnail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Article thumbnail image URL"
          }
        }
      }
    }
  },
  "required": [
    "query",
    "returned",
    "results"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "brave-search": {
      "url": "https://gateway.pipeworx.io/brave-search/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build May 21, 2026