{
  "info": {
    "name": "World News API — mcp.ai",
    "description": "REST API for the World News API MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/world_news_api",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "world_news_api_extract_news",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/extract/news",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "extract",
            "news"
          ]
        },
        "description": "Extract structured content from a public article URL. The call costs 2 quota points, plus 2 additional points when analyze is true. Paywalled or login-protected pages may return incomplete content.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"analyze\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_extract_news_links",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/extract/news/links",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "extract",
            "news",
            "links"
          ]
        },
        "description": "Extract article links from a news homepage or section page. The call costs 1 quota point, and an empty link list is a successful result.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"prefix\": \"\",\n  \"include_subdomains\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_generate_rss_feed",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/generate/rss/feed",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "generate",
            "rss",
            "feed"
          ]
        },
        "description": "Generate an RSS 2.0 XML feed from a public news homepage or section URL. Returns raw XML text. The call costs 1 quota point, plus 0.5 points per feed item when extract_news is true.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"extract_news\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_get_geo_coordinates",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/geo/coordinates",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "geo",
            "coordinates"
          ]
        },
        "description": "Resolve a place name or address to latitude and longitude for use in Search News location_filter. Costs 1 quota point.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"location\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_get_news_by_ids",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/news/by/ids",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "news",
            "by",
            "ids"
          ]
        },
        "description": "Retrieve full article records for IDs returned by Search News or Get Top News. Costs 0.1 quota points per returned article.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_get_top_news",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/top/news",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "top",
            "news"
          ]
        },
        "description": "Return relevance-ranked top-news clusters for a country, language, and optional date. Costs 1 quota point; Free accounts can request about one month of history.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"date\": \"\",\n  \"language\": \"\",\n  \"headlines_only\": false,\n  \"source_country\": \"\",\n  \"max_news_per_cluster\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_search_news",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/news",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "news"
          ]
        },
        "description": "Search indexed news articles. Provide at least one anchor filter: text, source country, language, news sources, authors, categories, entities, or location. Date, sentiment, and text-match fields only ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"text\": \"\",\n  \"number\": 0,\n  \"offset\": 0,\n  \"authors\": \"\",\n  \"entities\": \"\",\n  \"language\": \"\",\n  \"categories\": \"\",\n  \"news_sources\": \"\",\n  \"max_sentiment\": 0,\n  \"min_sentiment\": 0,\n  \"sort_direction\": \"\",\n  \"source_country\": \"\",\n  \"location_filter\": \"\",\n  \"text_match_indexes\": \"\",\n  \"latest_publish_date\": \"\",\n  \"earliest_publish_date\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "world_news_api_search_news_sources",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/news/sources",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "news",
            "sources"
          ]
        },
        "description": "Search monitored news sources by partial name and report matching source URLs and languages. Costs 1 quota point.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}