`sources`

Pack: newsapi · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/sources for the schema, then POST the same URL with its arguments for the data.

Return available NewsAPI publisher sources, filterable by category, language, and country. Returns source id, name, description, URL, and category — use source ids to filter top_headlines or everything.

Parameters

Name	Type	Required
`category`	string	no
`language`	string	no
`country`	string	no

Example call

Arguments

{
  "category": "business",
  "language": "en"
}

curl

curl -X POST https://gateway.pipeworx.io/newsapi/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sources","arguments":{"category":"business","language":"en"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('sources', {
  "category": "business",
  "language": "en"
});

More examples

{
  "country": "gb"
}

Response shape

Field	Type	Description
`status`	string	API response status
`sources`	array	Array of news source objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "API response status"
    },
    "sources": {
      "type": "array",
      "description": "Array of news source objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Source ID"
          },
          "name": {
            "type": "string",
            "description": "Source name"
          },
          "description": {
            "type": "string",
            "description": "Source description"
          },
          "url": {
            "type": "string",
            "description": "Source URL"
          },
          "category": {
            "type": "string",
            "description": "News category"
          },
          "language": {
            "type": "string",
            "description": "Language code"
          },
          "country": {
            "type": "string",
            "description": "Country code"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the newsapi pack

{
  "mcpServers": {
    "newsapi": {
      "url": "https://gateway.pipeworx.io/newsapi/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

sources