---
title: "Read-only MCP/A2A compatibility diagnostic from controlled failure categories"
method: GET
path: "/api/machine/connection-doctor"
tags: ["Discovery"]
---

# Read-only MCP/A2A compatibility diagnostic from controlled failure categories

`GET /api/machine/connection-doctor`

## Request

- Base URL: `https://aiwebsignals.com`
- URL: `https://aiwebsignals.com/api/machine/connection-doctor`
- Auth: none required

## Query parameters

- `surface` 'mcp' | 'a2a', required
- `operation` 'initialize' | 'notifications/initialized' | 'tools/list' | 'tools/call' | 'ping' | 'SendMessage' | 'GetTask' | 'tasks/get' | 'tasks/send' | 'message/send' | 'message/stream' | 'other'
- `reason` 'unsupported_protocol_version' | 'legacy_modern_envelope_mismatch' | 'protocol_negotiation' | 'standard_header_mismatch' | 'unsupported_accept_media' | 'unsupported_content_type' | 'invalid_jsonrpc_request' | 'invalid_params' | 'unsupported_method' | 'invalid_session' | 'session_required' | 'parse_error' | 'forbidden_by_security_policy' | 'not_found' | 'rate_limited' | 'server_error' | 'other_http_error' | 'unclassified_bad_request' | 'unknown'
- `protocol_version` '2026-07-28' | '2025-11-25' | '2025-06-18' | '2025-03-26' | '1.0' | '0.3' | 'absent' | 'unknown'

## Response `200`

Structured safe connection correction steps

## Other responses

- `400`: Invalid taxonomy

---

[API](https://skmtc.dev/aiwebsignals/apis/aiwebsignals-public-machine-api.md) · [All operations](https://skmtc.dev/aiwebsignals/apis/aiwebsignals-public-machine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiwebsignals/apis/aiwebsignals-public-machine-api/revisions/43d19fab1b5f?raw)