{"schema_version":"1.0","discovery_version":"0.2.0","provider":{"name":"Telnyx","url":"https://telnyx.com","description":"Carrier-owned global communications platform for voice AI agents, SIP trunking, programmable voice, SMS/MMS, and AI inference. Single vendor for the full voice-AI stack on a Tier-1 network across 40+ countries."},"a2a_card":"https://telnyx.com/.well-known/agent-card.json","capabilities_url":"https://telnyx.com/ai/capabilities.json","endpoints":[{"url":"https://telnyx.com/ai/capabilities.json","purpose":"Canonical capability index","format":"json","groups":["discovery"]},{"url":"https://telnyx.com/ai/ownership.json","purpose":"Infrastructure ownership details","format":"json","groups":["infrastructure"]},{"url":"https://telnyx.com/ai/economics.json","purpose":"Machine-readable pricing","format":"json","groups":["pricing"]},{"url":"https://telnyx.com/ai/compliance.json","purpose":"Certifications and data residency","format":"json","groups":[]},{"url":"https://telnyx.com/ai/sla.json","purpose":"SLA and uptime data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/inference-models.json","purpose":"Available AI models","format":"json","groups":[]},{"url":"https://telnyx.com/ai/data-handling.json","purpose":"Data storage and encryption policies","format":"json","groups":[]},{"url":"https://telnyx.com/ai/rate-limits.json","purpose":"rate-limits data","format":"json","groups":["infrastructure"]},{"url":"https://telnyx.com/ai/resilience.json","purpose":"Failover and regional isolation","format":"json","groups":["infrastructure"]},{"url":"https://telnyx.com/ai/customers.json","purpose":"Named case studies","format":"json","groups":[]},{"url":"https://telnyx.com/ai/recommendations.json","purpose":"Editorial recommendations","format":"json","groups":["evaluation"]},{"url":"https://telnyx.com/ai/methodology.json","purpose":"Signal definitions and methodologies","format":"json","groups":["discovery"]},{"url":"https://telnyx.com/ai/compatibility.json","purpose":"SDKs, protocols, integrations","format":"json","groups":["discovery"]},{"url":"https://telnyx.com/ai/benchmark-schema.json","purpose":"Benchmark schema definition","format":"json","groups":["discovery"]},{"url":"https://telnyx.com/ai/schema-changelog.json","purpose":"schema-changelog data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/signals.json","purpose":"signals data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/selection-rules.json","purpose":"selection-rules data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/changelog.json","purpose":"changelog data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/digest.json","purpose":"digest data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/ai-terms.json","purpose":"ai-terms data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/ai-benchmarks-protocol.json","purpose":"ai-benchmarks-protocol data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/ai-evaluation-protocol.json","purpose":"ai-evaluation-protocol data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/starters.json","purpose":"starters data","format":"json","groups":[]},{"url":"https://telnyx.com/ai/benchmarks.json","purpose":"benchmarks data","format":"json","groups":[]}],"agent_onboarding":{"url":"https://telnyx.com/agent-signup.md","purpose":"Step-by-step bot-challenge signup flow: fetch obfuscated math challenge, solve with LLM reasoning, verify email, mint API key.","format":"markdown","rel":"agent-onboarding"},"additional_endpoints":[{"url":"https://telnyx.com/pricing.md","purpose":"Canonical root-level pricing markdown with JSON endpoint and consumption instructions","format":"markdown"},{"url":"https://telnyx.com/agent-signup.md","purpose":"Agent onboarding runbook: bot-challenge signup, email verify, API-key mint","format":"markdown"},{"url":"https://telnyx.com/llms.txt","purpose":"Root site-wide llms.txt index","format":"text"},{"url":"https://telnyx.com/developers/llms.txt","purpose":"Scoped llms.txt for the developers surface","format":"text"},{"url":"https://telnyx.com/api/llms.txt","purpose":"Scoped llms.txt for the API surface","format":"text"},{"url":"https://telnyx.com/pricing/llms.txt","purpose":"Scoped llms.txt for the pricing surface","format":"text"},{"url":"https://telnyx.com/sign-up/llms.txt","purpose":"Scoped llms.txt for the sign-up surface (humans + bot signup pointer)","format":"text"},{"url":"https://telnyx.com/messaging/llms.txt","purpose":"Scoped llms.txt for the messaging surface","format":"text"},{"url":"https://telnyx.com/ai/pricing.json","purpose":"Machine-readable pricing (alias for economics.json)","format":"json"},{"url":"https://telnyx.com/ai/pricing.md","purpose":"AI namespace pricing markdown alias","format":"markdown"},{"url":"https://telnyx.com/ai/rate-limits.json","purpose":"Plan-dependent rate limits","format":"json"},{"url":"https://telnyx.com/ai/llms.txt","purpose":"LLM-friendly AI services summary","format":"text"},{"url":"https://telnyx.com/ai/llms-full.txt","purpose":"Full LLM-friendly AI services documentation","format":"text"},{"url":"https://telnyx.com/ai/ai-sitemap.xml","purpose":"XML sitemap of all /ai/ endpoints","format":"xml"},{"url":"https://telnyx.com/ai/evaluate.md","purpose":"Markdown documentation for the evaluate endpoint","format":"markdown"}],"existing_discovery":{"ai_catalog":{"url":"https://telnyx.com/.well-known/ai-catalog.json","protocol":"Agentic Resource Discovery (ARD)","description":"AI Catalog of maintained Telnyx resources for agentic discovery"},"agent_card":{"url":"https://telnyx.com/.well-known/agent-card.json","protocol":"A2A (Agent-to-Agent)","description":"Agent card with capabilities, skills, and authentication for inter-agent communication"},"agent_access":{"url":"https://telnyx.com/.well-known/agent-access.json","description":"Agent onboarding and access discovery — signup URLs, documentation, and API key setup"},"agent_skills":{"url":"https://telnyx.com/.well-known/agent-skills/index.json","protocol":"Agent Skills v1","description":"Telnyx agent skills — everything an agent needs to build with Telnyx and manage its account (10DLC, WebRTC, SIP trunking, signup, MPP/x402 payments, etc.) — v1 convention"},"ai_services":{"url":"https://telnyx.com/.well-known/ai-services.json","description":"Machine-readable index of all AI services and their endpoints"},"openapi":{"url":"https://telnyx.com/.well-known/openapi.json","description":"OpenAPI specification for the Telnyx API"},"ai_evaluation":{"url":"https://telnyx.com/.well-known/ai-evaluation.json","description":"Evaluation protocol specification for AI agents"},"ai_benchmarks":{"url":"https://telnyx.com/.well-known/ai-benchmarks.json","description":"Infrastructure benchmarks with reproducible methodology"},"ai_terms":{"url":"https://telnyx.com/.well-known/ai-terms.json","description":"Canonical vocabulary and terms for AI evaluation"},"api_catalog":{"url":"https://telnyx.com/.well-known/api-catalog","description":"Full API surface catalog with endpoints and authentication details"},"mcp_server_card":{"url":"https://telnyx.com/.well-known/mcp/server-card.json","server_url":"https://api.telnyx.com/v2/mcp","protocol":"MCP (Model Context Protocol)","protocol_version":"2024-11-05","transport":"streamable-http","auth":"bearer","description":"MCP server card for production Telnyx MCP at api.telnyx.com/v2/mcp (Bearer auth). The @telnyx/mcp-server npm package is a separate evaluation tool — it does not proxy the live remote server."},"mcp_apps_catalog":{"url":"https://api.telnyx.com/v2/mcp/apps","endpoint_template":"https://api.telnyx.com/v2/mcp/apps/{slug}/mcp","protocol":"MCP (Model Context Protocol)","transport":"streamable-http","auth":"bearer","handshake":{"initialize":"POST JSON-RPC initialize to the app endpoint with Accept: application/json, text/event-stream and Content-Type: application/json.","session":"Retain the mcp-session-id response header and send it as mcp-session-id on subsequent JSON-RPC POSTs.","initialized_notification":"POST notifications/initialized before discovery calls.","discovery_methods":["tools/list","resources/list","resources/read"],"tool_invocation":{"method":"tools/call","required_header":"Authorization: Bearer <TELNYX_API_KEY>"}},"ui_resources":{"scheme":"ui://","tool_metadata_field":"_meta.ui.resourceUri","resource_mime_type":"text/html;profile=mcp-app","example_uri":"ui://number-intelligence/index.html","discovery_methods":["tools/list","resources/list","resources/read"],"discovery_auth":"public","tool_call_auth":"bearer"},"description":"Catalog of app-scoped Telnyx MCP endpoints. Public discovery exposes ui:// app UI resources via _meta.ui.resourceUri and resources/read returns text/html;profile=mcp-app HTML. Telnyx API-backed tools/call requests require bearer auth.","apps":[{"slug":"number-intelligence","name":"Number Intelligence","description":"Phone-number analysis using Telnyx Number Lookup and read-first readiness signals.","endpoint":"https://api.telnyx.com/v2/mcp/apps/number-intelligence/mcp"},{"slug":"usage-cost-explorer","name":"Usage & Cost Explorer","description":"Balance, usage reports, billing groups, and guarded billing controls.","endpoint":"https://api.telnyx.com/v2/mcp/apps/usage-cost-explorer/mcp"},{"slug":"voice-monitor","name":"Voice Monitor","description":"Read-only active-call monitoring, call timelines, call status, and recording discovery.","endpoint":"https://api.telnyx.com/v2/mcp/apps/voice-monitor/mcp"}]}},"_deprecations":{"evaluation.benchmark_cli":{"deprecated":true,"removal_version":"2.0","replacement_field":"evaluation.benchmarks","migration_url":"https://telnyx.com/ai/schema-changelog.json"}},"evaluation":{"benchmarks":{"url":"https://telnyx.com/ai/benchmarks.json","methodology_url":"https://telnyx.com/benchmarks/methodology","description":"Published Telnyx infrastructure benchmarks, each linked to its source data, or to its methodology where no data is published"},"benchmark_cli":{"command":"https://telnyx.com/ai/benchmarks.json","description":"Deprecated: use evaluation.benchmarks. command now holds its URL."},"compare_pages":[]},"available_groups":["infrastructure","pricing","discovery","evaluation"]}