{"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"]}}]}