Back to TopAI Sovereign Gateway & Universal MCP Hub
Card snapshot
mcp-server-hub.topaisaas.workers.dev
·
2026-10-24 04:27:31 UTC
·
b32b40a4962e509f2438022c48b288be807f2d0e6319b9b8bf69f99cf7aa182d
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"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"
]
}
}
]
}