TopAI Sovereign Gateway & Universal MCP Hub

{
  "schema_version": "1.0",
  "protocol": "mcp+a2a",
  "mcp_version": "2024-11-05",
  "name": "TopAI Sovereign Gateway & Universal MCP Hub",
  "id": "universal-mcp-server-hub",
  "version": "1.0.2",
  "description": "Sub-30ms Deterministic AI Edge Gateway & Universal MCP Server Hub bundling 19 native MCP tools and 400+ deterministic APIs (Web-to-Markdown, TokenSlimmer -70% LLM cost cutter, Prompt Shield, SEPA IBAN VoP, EU AI Act & DORA compliance).",
  "url": "https://topaigateway.com",
  "homepage": "https://topaigateway.com",
  "documentationUrl": "https://topaigateway.com/docs",
  "pricingUrl": "https://topaigateway.com/#pricing",
  "openapiUrl": "https://topaigateway.com/openapi.json",
  "provider": {
    "organization": "TopAI Sovereign Gateway",
    "url": "https://topaigateway.com"
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "mcp": true,
    "tools_count": 19
  },
  "endpoints": {
    "mcp_jsonrpc": "https://mcp-server-hub.topaisaas.workers.dev/mcp",
    "mcp_sse": "https://mcp-server-hub.topaisaas.workers.dev/sse",
    "mcp_messages": "https://mcp-server-hub.topaisaas.workers.dev/messages",
    "tools_list": "https://mcp-server-hub.topaisaas.workers.dev/v1/mcp/tools",
    "health": "https://mcp-server-hub.topaisaas.workers.dev/v1/health"
  },
  "authentication": {
    "schemes": [
      "Bearer",
      "X-RapidAPI-Key",
      "None (Free Tier Sandbox)"
    ],
    "required": false,
    "signup_url": "https://topaigateway.com"
  },
  "pricing": {
    "currency": "EUR",
    "free_tier": {
      "requests_per_month": 100,
      "price": 0
    },
    "packs": [
      {
        "name": "Pack 1 - DevEx & FinOps (100 APIs)",
        "price_eur_month": 14,
        "quota": 10000
      },
      {
        "name": "Pack 2 - Squad Velocity (210 APIs)",
        "price_eur_month": 29,
        "quota": 50000
      },
      {
        "name": "Pack 3 - High-Scale & Infra (310 APIs)",
        "price_eur_month": 79,
        "quota": 250000
      },
      {
        "name": "Pack 4 - Sovereign Enterprise (400 APIs + DORA)",
        "price_eur_month": 199,
        "quota": 1000000
      }
    ]
  },
  "tools": [
    {
      "name": "topai_web_to_markdown",
      "description": "Extract clean, ad-free, noise-free Markdown and metadata from any public website URL for LLM context windows.",
      "annotations": {
        "title": "Web to Clean Markdown",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Target web URL to convert to Markdown (e.g. 'https://stripe.com')"
          },
          "include_links": {
            "type": "boolean",
            "description": "Whether to retain anchor links in the Markdown output (default: true)"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Original source URL"
          },
          "title": {
            "type": "string",
            "description": "Extracted document title"
          },
          "markdown": {
            "type": "string",
            "description": "Clean, advertisement-free markdown text"
          },
          "length": {
            "type": "integer",
            "description": "Character count of markdown content"
          },
          "tokens_saved_estimate": {
            "type": "integer",
            "description": "Estimated tokens saved compared to raw HTML"
          }
        },
        "required": [
          "markdown",
          "title"
        ]
      }
    },
    {
      "name": "topai_b2b_data_leads",
      "description": "Search, filter, and extract verified B2B leads by industry, country, company size, and executive job role.",
      "annotations": {
        "title": "B2B Lead Generation & Directory",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "industry": {
            "type": "string",
            "description": "Target industry or vertical (e.g. 'SaaS', 'Fintech', 'Healthcare', 'E-commerce')"
          },
          "country": {
            "type": "string",
            "description": "Two-letter ISO country code (e.g. 'US', 'FR', 'DE', 'GB')"
          },
          "limit": {
            "type": "integer",
            "description": "Maximum number of leads to return (1-50, default: 10)"
          }
        },
        "required": [
          "industry"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "industry": {
            "type": "string",
            "description": "Queried industry filter"
          },
          "total_found": {
            "type": "integer",
            "description": "Total qualified leads matching criteria"
          },
          "leads": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "company": {
                  "type": "string"
                },
                "domain": {
                  "type": "string"
                },
                "contact_name": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                },
                "employees": {
                  "type": "string"
                }
              },
              "required": [
                "company",
                "domain",
                "contact_name",
                "email"
              ]
            },
            "description": "List of structured B2B lead profiles"
          }
        },
        "required": [
          "industry",
          "total_found",
          "leads"
        ]
      }
    },
    {
      "name": "topai_company_enrichment",
      "description": "Deep B2B company intelligence: returns company name, sector, employee range, technographics, and contact graph from domain.",
      "annotations": {
        "title": "B2B Company Deep Enrichment",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Company domain name (e.g. 'linear.app', 'figma.com')"
          }
        },
        "required": [
          "domain"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Queried domain"
          },
          "company_name": {
            "type": "string",
            "description": "Normalized legal or brand name"
          },
          "sector": {
            "type": "string",
            "description": "Industry sector"
          },
          "employee_range": {
            "type": "string",
            "description": "Estimated workforce size range"
          },
          "technologies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Detected software and infrastructure"
          },
          "social_links": {
            "type": "object",
            "description": "Social media links"
          }
        },
        "required": [
          "domain",
          "company_name"
        ]
      }
    },
    {
      "name": "topai_ai_web_search",
      "description": "Real-time, noise-free web search engine for grounding AI agents with current facts, URLs, and summaries.",
      "annotations": {
        "title": "AI Real-Time Web Search & Grounding",
        "readOnlyHint": true,
        "idempotentHint": false,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query string (e.g. 'latest Claude 3.7 benchmarks')"
          },
          "max_results": {
            "type": "integer",
            "description": "Maximum results to retrieve (1-10, default: 5)"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query executed"
          },
          "results_count": {
            "type": "integer",
            "description": "Number of items retrieved"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "snippet": {
                  "type": "string"
                }
              },
              "required": [
                "title",
                "url",
                "snippet"
              ]
            }
          }
        },
        "required": [
          "query",
          "results"
        ]
      }
    },
    {
      "name": "topai_semantic_cache",
      "description": "Sub-5ms semantic cache lookup and storage for LLM prompts to eliminate redundant generation latency and token expenses.",
      "annotations": {
        "title": "LLM Semantic Vector Cache",
        "readOnlyHint": false,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "get",
              "set"
            ],
            "description": "Cache action: 'get' to look up existing cached completion, 'set' to store a new completion"
          },
          "prompt": {
            "type": "string",
            "description": "User prompt text to evaluate for semantic similarity"
          },
          "response": {
            "type": "string",
            "description": "Completion response text to store when action is 'set'"
          }
        },
        "required": [
          "action",
          "prompt"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "cached": {
            "type": "boolean",
            "description": "True if cache hit occurred"
          },
          "similarity": {
            "type": "number",
            "description": "Semantic vector similarity score (0.0 to 1.0)"
          },
          "response": {
            "type": "string",
            "description": "Cached or newly stored response text"
          },
          "tokens_saved": {
            "type": "integer",
            "description": "Estimated LLM tokens saved by cache hit"
          },
          "latency_saved_ms": {
            "type": "integer",
            "description": "Estimated inference time saved in milliseconds"
          }
        },
        "required": [
          "cached",
          "similarity"
        ]
      }
    },
    {
      "name": "topai_invoice_extractor",
      "description": "Structured financial entity parser: extracts vendor, invoice number, IBAN, line items, and totals from receipt/invoice text.",
      "annotations": {
        "title": "Invoice & PDF Entity Extractor",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "description": "Raw invoice OCR or PDF text"
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "vendor_name": {
            "type": "string",
            "description": "Detected company or merchant"
          },
          "invoice_number": {
            "type": "string",
            "description": "Extracted invoice reference ID"
          },
          "invoice_date": {
            "type": "string",
            "description": "Standardized ISO date"
          },
          "total_amount": {
            "type": "number",
            "description": "Invoice gross total"
          },
          "vat_amount": {
            "type": "number",
            "description": "Extracted VAT amount"
          },
          "currency": {
            "type": "string",
            "description": "Currency code (EUR, USD, GBP)"
          },
          "line_items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "description": {
                  "type": "string"
                },
                "quantity": {
                  "type": "number"
                },
                "unit_price": {
                  "type": "number"
                },
                "total": {
                  "type": "number"
                }
              }
            }
          }
        },
        "required": [
          "total_amount"
        ]
      }
    },
    {
      "name": "topai_headless_screenshot",
      "description": "High-fidelity serverless web screenshot renderer: captures full-page or viewport visual captures and DOM metadata.",
      "annotations": {
        "title": "Headless Webpage Visual Capture",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Target webpage URL to capture (e.g. 'https://github.com')"
          },
          "full_page": {
            "type": "boolean",
            "description": "Whether to capture full document height (default: false)"
          },
          "format": {
            "type": "string",
            "enum": [
              "png",
              "jpeg",
              "webp"
            ],
            "description": "Output image format (default: 'png')"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Target URL captured"
          },
          "status": {
            "type": "string",
            "description": "Capture status ('success', 'rendered')"
          },
          "screenshot_url": {
            "type": "string",
            "description": "Public URL or data URI of captured image"
          },
          "dimensions": {
            "type": "object",
            "properties": {
              "width": {
                "type": "integer"
              },
              "height": {
                "type": "integer"
              }
            },
            "required": [
              "width",
              "height"
            ]
          },
          "load_time_ms": {
            "type": "integer",
            "description": "Page render time in milliseconds"
          }
        },
        "required": [
          "url",
          "status"
        ]
      }
    },
    {
      "name": "topai_prompt_shield",
      "description": "Sub-millisecond prompt firewall: detects adversarial prompt injections, jailbreaks, toxic inputs, and PII leakage.",
      "annotations": {
        "title": "LLM Prompt Shield & Firewall",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "description": "User prompt or external text to inspect"
          }
        },
        "required": [
          "prompt"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "is_safe": {
            "type": "boolean",
            "description": "True if prompt is safe, false if attack detected"
          },
          "threat_score": {
            "type": "number",
            "description": "Threat probability from 0.0 to 1.0"
          },
          "attack_category": {
            "type": "string",
            "description": "Detected category: none, jailbreak, injection, toxicity, pii"
          },
          "flagged_tokens": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Suspicious keywords identified"
          }
        },
        "required": [
          "is_safe",
          "threat_score"
        ]
      }
    },
    {
      "name": "topai_token_slimmer",
      "description": "Lossless compression for External HTML, JSON, or text payloads to cut LLM tokens by 30-70% (preserves 64-bit integers and null fields by default).",
      "annotations": {
        "title": "TokenSlimmer Context Compressor",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "description": "Raw HTML, JSON, or text string to compress"
          },
          "format": {
            "type": "string",
            "description": "Format type: 'html', 'json', or 'text'",
            "enum": [
              "html",
              "json",
              "text"
            ]
          },
          "strip_nulls": {
            "type": "boolean",
            "description": "Set true to strip null/empty fields, or false to preserve all 'key': null fields (default: false)"
          },
          "output_mode": {
            "type": "string",
            "enum": [
              "auto",
              "json",
              "tsv"
            ],
            "description": "Output encoding for JSON inputs: 'auto' (TSV for flat arrays, minified JSON for objects), 'json' (strict JSON), or 'tsv' (default: 'auto')"
          }
        },
        "required": [
          "content"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "original_length": {
            "type": "integer",
            "description": "Character count before slimming"
          },
          "slimmer_length": {
            "type": "integer",
            "description": "Character count after compression"
          },
          "compression_ratio_percent": {
            "type": "number",
            "description": "Percentage size reduction"
          },
          "estimated_tokens_saved": {
            "type": "integer",
            "description": "Estimated LLM tokens saved"
          },
          "compressed_content": {
            "type": "string",
            "description": "Compressed payload ready for prompt insertion"
          }
        },
        "required": [
          "compression_ratio_percent",
          "compressed_content"
        ]
      }
    },
    {
      "name": "topai_agentvision_crop",
      "description": "AI Agent visual ROI cropper: detects text blocks, UI buttons, charts, and tables from images for multimodal LLMs to slash vision tokens.",
      "annotations": {
        "title": "AgentVision ROI Smart Crop",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "image_url": {
            "type": "string",
            "description": "Public URL of the image to analyze and crop"
          },
          "target_element": {
            "type": "string",
            "enum": [
              "auto",
              "button",
              "table",
              "text_block",
              "chart",
              "header"
            ],
            "description": "Target visual element type to detect and crop (default: 'auto')"
          }
        },
        "required": [
          "image_url"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "image_url": {
            "type": "string",
            "description": "Source image URL"
          },
          "target_element": {
            "type": "string",
            "description": "Detected element category"
          },
          "crop_box": {
            "type": "object",
            "properties": {
              "x": {
                "type": "integer"
              },
              "y": {
                "type": "integer"
              },
              "width": {
                "type": "integer"
              },
              "height": {
                "type": "integer"
              }
            },
            "required": [
              "x",
              "y",
              "width",
              "height"
            ]
          },
          "vision_tokens_saved_percent": {
            "type": "number",
            "description": "Percentage token bill reduction"
          },
          "confidence": {
            "type": "number",
            "description": "Bounding box detection confidence (0.0 to 1.0)"
          }
        },
        "required": [
          "crop_box",
          "vision_tokens_saved_percent"
        ]
      }
    },
    {
      "name": "topai_math_fact_checker",
      "description": "Deterministic financial, VAT, and invoice math engine using exact decimal HALF_UP (default) or HALF_EVEN rounding.",
      "annotations": {
        "title": "Deterministic Math & VAT Fact-Checker",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "operation": {
            "type": "string",
            "description": "Operation type: 'vat_calculate', 'invoice_reconcile', or 'business_days'",
            "enum": [
              "vat_calculate",
              "invoice_reconcile",
              "business_days"
            ]
          },
          "amount": {
            "type": "number",
            "description": "Net amount for vat_calculate or claimed total for invoice_reconcile"
          },
          "total": {
            "type": "number",
            "description": "Optional claimed gross total (TTC) to verify against calculated total"
          },
          "rate_percent": {
            "type": "number",
            "description": "Tax rate percentage (e.g. 20.0 for 20% VAT)"
          },
          "rounding_mode": {
            "type": "string",
            "enum": [
              "HALF_UP",
              "HALF_EVEN",
              "HALF_DOWN"
            ],
            "description": "Decimal rounding rule: 'HALF_UP' (commercial standard: 1.005 -> 1.01, default), 'HALF_EVEN' (banker's: 1.005 -> 1.00), or 'HALF_DOWN'"
          },
          "items": {
            "type": "array",
            "description": "Array of items [{ description, quantity, unit_price, total }] for invoice reconciliation"
          },
          "invoices": {
            "type": "array",
            "description": "Optional batch of multiple invoices [{ id, rate_percent, total, items }] to reconcile in a single call"
          }
        },
        "required": [
          "operation"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "operation": {
            "type": "string",
            "description": "Executed operation"
          },
          "result": {
            "type": "number",
            "description": "Calculated mathematical result"
          },
          "formatted": {
            "type": "string",
            "description": "Formatted representation"
          },
          "is_valid": {
            "type": "boolean",
            "description": "Validation check outcome"
          },
          "audit_trail": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Step-by-step arithmetic verification trace"
          }
        },
        "required": [
          "operation"
        ]
      }
    },
    {
      "name": "topai_techstack_fingerprint",
      "description": "Sub-50ms BuiltWith alternative: detect 70+ CMS, eCommerce, CRM, Analytics, and CDN technologies powering a domain.",
      "annotations": {
        "title": "TechStack Technographic Fingerprinter",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Domain to fingerprint (e.g. 'gymshark.com')"
          }
        },
        "required": [
          "domain"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Fingerprinted domain"
          },
          "total_technologies": {
            "type": "integer",
            "description": "Count of identified tools"
          },
          "cms": {
            "type": "string",
            "description": "Content management system"
          },
          "ecommerce": {
            "type": "string",
            "description": "E-commerce engine"
          },
          "analytics": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cdn": {
            "type": "string",
            "description": "CDN / Hosting provider"
          },
          "frameworks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "domain",
          "total_technologies"
        ]
      }
    },
    {
      "name": "topai_polymarket_arbitrage",
      "description": "Real-time Polymarket prediction market odds, cross-platform mispricing delta vs bookmakers, and Kelly criterion bankroll position sizer.",
      "annotations": {
        "title": "Polymarket Odds & Arbitrage Delta",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "polymarket_price": {
            "type": "number",
            "description": "Polymarket YES contract price (0.01 to 0.99)"
          },
          "reference_probability": {
            "type": "number",
            "description": "Reference true probability (e.g. 0.72 or 72)"
          },
          "bankroll_usd": {
            "type": "number",
            "description": "Total bankroll in USD to calculate dollar sizing"
          }
        },
        "required": [
          "polymarket_price",
          "reference_probability"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "market_probability": {
            "type": "number",
            "description": "Implied probability on Polymarket (0.00 to 1.00)"
          },
          "reference_probability": {
            "type": "number",
            "description": "True probability benchmark"
          },
          "mispricing_delta": {
            "type": "number",
            "description": "Delta percentage"
          },
          "expected_value_percent": {
            "type": "number",
            "description": "EV percentage"
          },
          "kelly_fraction": {
            "type": "number",
            "description": "Recommended fractional Kelly criterion bet size"
          },
          "recommended_stake_usd": {
            "type": "number",
            "description": "Dollar amount to allocate based on bankroll"
          }
        },
        "required": [
          "market_probability",
          "mispricing_delta",
          "kelly_fraction"
        ]
      }
    },
    {
      "name": "topai_mcp_hub_registry",
      "description": "Introspect, list capabilities, and discover available MCP tools across the TopAI SaaS edge server portfolio.",
      "annotations": {
        "title": "TopAI MCP Tool Registry & Discovery",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string",
            "description": "Optional category filter (e.g. 'scraping', 'finance', 'healthcare', 'intelligence')"
          },
          "search": {
            "type": "string",
            "description": "Optional search keyword to match against tool names and descriptions"
          }
        },
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "total_tools": {
            "type": "integer",
            "description": "Total registered tools count"
          },
          "version": {
            "type": "string",
            "description": "MCP Server protocol release"
          },
          "tools": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "title",
                "description"
              ]
            }
          }
        },
        "required": [
          "total_tools",
          "tools"
        ]
      }
    },
    {
      "name": "topai_pharmapatent_watcher",
      "description": "Global pharmaceutical patent expiration & generic entry tracker: queries Orange Book, exclusivity expiry dates, and generic threat levels.",
      "annotations": {
        "title": "Pharma Patent Expiration Watcher",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "drug_name": {
            "type": "string",
            "description": "Brand or molecule drug name (e.g. 'Humira', 'Keytruda', 'Ozempic', 'Eliquis')"
          },
          "jurisdiction": {
            "type": "string",
            "enum": [
              "US",
              "EP",
              "ALL"
            ],
            "description": "Target patent jurisdiction (default: 'US')"
          }
        },
        "required": [
          "drug_name"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "drug_name": {
            "type": "string",
            "description": "Queried pharmaceutical name"
          },
          "active_ingredient": {
            "type": "string",
            "description": "Active chemical or biologic substance"
          },
          "loss_of_exclusivity_date": {
            "type": "string",
            "description": "Standardized expiry date (YYYY-MM-DD)"
          },
          "generic_threat_level": {
            "type": "string",
            "description": "Threat tier: LOW, MEDIUM, IMMINENT"
          },
          "patents_count": {
            "type": "integer",
            "description": "Count of active blocking patents"
          },
          "patents": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "patent_number": {
                  "type": "string"
                },
                "expiration_date": {
                  "type": "string"
                },
                "claims": {
                  "type": "string"
                }
              }
            }
          }
        },
        "required": [
          "drug_name",
          "loss_of_exclusivity_date",
          "generic_threat_level"
        ]
      }
    },
    {
      "name": "topai_healthcare_validator",
      "description": "Real-time medical professional license, NPI (National Provider Identifier Luhn 80840), and credentials verification engine.",
      "annotations": {
        "title": "Healthcare Provider & NPI Validator",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "npi_number": {
            "type": "string",
            "description": "10-digit National Provider Identifier (e.g. '1234567893')"
          },
          "provider_name": {
            "type": "string",
            "description": "Optional provider surname or organization name"
          },
          "state": {
            "type": "string",
            "description": "Optional 2-letter state code (e.g. 'CA', 'NY', 'TX')"
          }
        },
        "required": [
          "npi_number"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "npi": {
            "type": "string",
            "description": "Queried NPI number"
          },
          "is_valid": {
            "type": "boolean",
            "description": "True if Luhn check and registry validation passed"
          },
          "provider_name": {
            "type": "string",
            "description": "Verified physician or facility legal name"
          },
          "specialty": {
            "type": "string",
            "description": "Primary medical specialty / taxonomy"
          },
          "status": {
            "type": "string",
            "description": "License status: ACTIVE, EXPIRED, REVOKED"
          },
          "state": {
            "type": "string",
            "description": "Licensed jurisdiction state"
          }
        },
        "required": [
          "npi",
          "is_valid",
          "status"
        ]
      }
    },
    {
      "name": "topai_google_ai_overview",
      "description": "Extract Google AI Overviews, cited source URLs, generative synthesis, and SERP organic snippets without headless browsers.",
      "annotations": {
        "title": "Google AI Overview & SERP Citations",
        "readOnlyHint": true,
        "idempotentHint": false,
        "destructiveHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Google search query string (e.g. 'best lightweight vector database 2026')"
          },
          "country": {
            "type": "string",
            "description": "Country code for SERP location (default: 'us')"
          },
          "language": {
            "type": "string",
            "description": "Language code (default: 'en')"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Original search query"
          },
          "has_ai_overview": {
            "type": "boolean",
            "description": "Whether an AI Overview was triggered"
          },
          "ai_overview_text": {
            "type": "string",
            "description": "Direct generative summary text from Google SGE"
          },
          "cited_sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "snippet": {
                  "type": "string"
                }
              },
              "required": [
                "title",
                "url"
              ]
            },
            "description": "Sources explicitly cited inside the AI Overview"
          },
          "organic_results_count": {
            "type": "integer",
            "description": "Number of standard organic links"
          }
        },
        "required": [
          "query",
          "has_ai_overview"
        ]
      }
    },
    {
      "name": "topai_disposable_email_shield",
      "description": "Real-time temporary, throwaway, and disposable email domain detector with live DNS MX record heuristics and RFC 5322 validation.",
      "annotations": {
        "title": "Disposable Email & Fraud Shield",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Email address to verify (e.g. 'test@tempmail.com')"
          }
        },
        "required": [
          "email"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "Analyzed email address"
          },
          "domain": {
            "type": "string",
            "description": "Extracted domain name"
          },
          "is_disposable": {
            "type": "boolean",
            "description": "True if disposable / burner service detected"
          },
          "is_valid_format": {
            "type": "boolean",
            "description": "RFC 5322 syntax validation outcome"
          },
          "risk_score": {
            "type": "number",
            "description": "Fraud score from 0.0 (clean) to 1.0 (high risk)"
          },
          "mx_record_valid": {
            "type": "boolean",
            "description": "True if DNS MX records exist"
          },
          "reason": {
            "type": "string",
            "description": "Verification classification reason"
          }
        },
        "required": [
          "email",
          "domain",
          "is_disposable",
          "risk_score"
        ]
      }
    },
    {
      "name": "topai_openapi_flattener",
      "description": "De-reference all $ref pointers, circular schemas, and bundle OpenAPI / Swagger specs into a single zero-dependency JSON payload.",
      "annotations": {
        "title": "OpenAPI Spec Flattener & Dereferencer",
        "readOnlyHint": true,
        "idempotentHint": true,
        "destructiveHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "spec_url": {
            "type": "string",
            "description": "Public URL to the OpenAPI / Swagger JSON spec to dereference"
          },
          "spec_json": {
            "type": "string",
            "description": "Raw OpenAPI JSON string if passing spec inline directly"
          }
        },
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Flattening status ('success', 'dereferenced')"
          },
          "refs_resolved": {
            "type": "integer",
            "description": "Count of JSON pointer $ref nodes dereferenced"
          },
          "circular_detected": {
            "type": "boolean",
            "description": "True if circular schema references were neutralized"
          },
          "endpoints_count": {
            "type": "integer",
            "description": "Total paths and operations identified"
          },
          "flattened_spec": {
            "type": "object",
            "description": "Dereferenced self-contained OpenAPI 3.0 object"
          }
        },
        "required": [
          "status",
          "refs_resolved"
        ]
      }
    }
  ]
}