{
  "spec": "webmcp/0.1",
  "tools": [
    {
      "name": "search-news",
      "description": "Search AIMode News headlines and summaries by keyword. Returns article cards linking to full stories.",
      "url": "/search",
      "method": "GET",
      "parameters": [
        {
          "name": "q",
          "type": "string",
          "description": "Search query (2+ characters)",
          "required": true
        }
      ]
    },
    {
      "name": "get-latest-news",
      "description": "Get the latest news articles as JSON with optional entity or category filters.",
      "url": "/api/news",
      "method": "GET",
      "parameters": [
        {
          "name": "limit",
          "type": "integer",
          "description": "Number of articles (1-100)",
          "required": false
        },
        {
          "name": "entity",
          "type": "string",
          "description": "Entity slug filter, e.g. openai, google, nvidia",
          "required": false
        },
        {
          "name": "category",
          "type": "string",
          "description": "Category filter: AI, Technology, Science, Business, World, Health",
          "required": false
        }
      ]
    },
    {
      "name": "get-topic-news",
      "description": "Get the latest news for a specific company or entity (e.g. OpenAI, Google, Apple, Nvidia).",
      "url": "/api/news",
      "method": "GET",
      "parameters": [
        {
          "name": "entity",
          "type": "string",
          "description": "Entity slug, e.g. openai, xai, spacex",
          "required": true
        }
      ]
    },
    {
      "name": "get-article",
      "description": "Get a single article by slug with its full summary and metadata.",
      "url": "/api/article/{slug}",
      "method": "GET",
      "parameters": [
        {
          "name": "slug",
          "type": "string",
          "description": "Article slug",
          "required": true
        }
      ]
    },
    {
      "name": "search-news-json",
      "description": "Search AIMode News headlines and summaries by keyword. Returns JSON article cards.",
      "url": "/api/search",
      "method": "GET",
      "parameters": [
        {
          "name": "q",
          "type": "string",
          "description": "Search query (2+ characters)",
          "required": true
        }
      ]
    },
    {
      "name": "get-trending",
      "description": "Get the most-viewed articles right now as JSON.",
      "url": "/api/trending",
      "method": "GET",
      "parameters": []
    },
    {
      "name": "get-categories",
      "description": "Get the list of editorial categories with descriptions and counts.",
      "url": "/api/categories",
      "method": "GET",
      "parameters": []
    },
    {
      "name": "get-sources",
      "description": "Get the list of publishers (sources) aggregated on AIMode News with per-source article counts and dominant category.",
      "url": "/api/sources",
      "method": "GET",
      "parameters": [
        {
          "name": "category",
          "type": "string",
          "description": "Filter by dominant category: AI, Technology, World, Science, Business, Health",
          "required": false
        }
      ]
    },
    {
      "name": "get-agent-registry",
      "description": "Get machine-verified AI agents registered with AIMode News (A2A agent-card verified).",
      "url": "/api/agents",
      "method": "GET",
      "parameters": []
    },
    {
      "name": "get-topic-feed",
      "description": "Get the RSS feed for a specific company or entity topic (e.g. OpenAI, Google, Apple, Nvidia). Returns RSS 2.0 XML.",
      "url": "/feed/topic/{slug}",
      "method": "GET",
      "parameters": [
        {
          "name": "slug",
          "type": "string",
          "description": "Entity slug, e.g. openai, xai, spacex",
          "required": true
        }
      ]
    },
    {
      "name": "get-category-feed",
      "description": "Get the RSS feed for an editorial category (AI, Technology, World, Science, Business, Health). Returns RSS 2.0 XML.",
      "url": "/feed/category/{slug}",
      "method": "GET",
      "parameters": [
        {
          "name": "slug",
          "type": "string",
          "description": "Category slug, e.g. ai, technology, science",
          "required": true
        }
      ]
    }
  ]
}