{"openapi":"3.1.0","info":{"title":"Static API","version":"0.1.0","description":"A home audio/video and electronics reference and calculator: cable/connector specs (HDMI, DisplayPort, optical, coax, USB-C), an HDMI version-to-bandwidth reference, a speaker-wire-gauge calculator, resolution/aspect-ratio reference and calculator, Dolby Atmos/DTS:X/surround audio-format reference, room acoustics basics, and A/V troubleshooting guides.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://static.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/static/docs"},"termsOfService":"https://connectorbay.com/static/terms"},"servers":[{"url":"https://static.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/static/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/cable_type_info":{"post":{"operationId":"cable_type_info","summary":"A real cable/connector type's connector shape, typical uses, bandwidth and notes — HDMI, DisplayPort,","description":"A real cable/connector type's connector shape, typical uses, bandwidth and notes — HDMI, DisplayPort,\n    optical (TOSLINK) or coaxial digital audio, USB-C, or speaker wire. Use for \"what is HDMI ARC\", \"what's the\n    difference between optical and coax audio\", \"what can USB-C carry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A cable/connector type, e.g. 'HDMI', 'DisplayPort', 'optical', 'coax', 'USB-C', 'speaker wire'.","title":"Name","type":"string"}},"required":["name"],"title":"cable_type_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hdmi_version_reference":{"post":{"operationId":"hdmi_version_reference","summary":"Real HDMI version-to-bandwidth mapping: exact Gbit/s bandwidth, max resolution/refresh rate, and key","description":"Real HDMI version-to-bandwidth mapping: exact Gbit/s bandwidth, max resolution/refresh rate, and key\n    features (ARC/eARC, VRR, ALLM, HDR, cable certification) for one HDMI version or the full history from 1.0\n    through 2.2. Use for \"what's the bandwidth of HDMI 2.1\", \"does HDMI 1.4 support 4K\", \"what added eARC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An HDMI version, e.g. '1.4', '2.0', '2.1'. Omit to list the full version history.","title":"Version"}},"title":"hdmi_version_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/speaker_wire_gauge_guide":{"post":{"operationId":"speaker_wire_gauge_guide","summary":"Recommends a speaker wire gauge (AWG) for a given one-way run length, using the standard","description":"Recommends a speaker wire gauge (AWG) for a given one-way run length, using the standard\n    audio-engineering guideline of keeping wire resistance under about 5% of the speaker's rated impedance —\n    given for both common 8-ohm and 4-ohm speaker loads, plus the full reference table. Use for \"what gauge\n    speaker wire for 50 feet\", \"do I need thicker wire for my subwoofer run\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"distance_ft":{"description":"One-way cable run length in feet, from amplifier to speaker.","exclusiveMinimum":0,"title":"Distance Ft","type":"number"},"power_watts":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Amplifier power to that speaker in watts, if known — used for an extra headroom note on high-power runs.","title":"Power Watts"}},"required":["distance_ft"],"title":"speaker_wire_gauge_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/resolution_reference":{"post":{"operationId":"resolution_reference","summary":"Exact pixel dimensions, aspect ratio and total pixel count for a named video resolution — 480p, 720p,","description":"Exact pixel dimensions, aspect ratio and total pixel count for a named video resolution — 480p, 720p,\n    1080p, 1440p, 4K UHD, DCI 4K (cinema), or 8K UHD — or the full list. Use for \"what resolution is 4K\", \"how\n    many pixels is 1080p\", \"what's the difference between 4K UHD and DCI 4K\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A resolution name, e.g. '1080p', '4K', '8K', '1440p', 'DCI 4K'. Omit to list them all.","title":"Name"}},"title":"resolution_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/aspect_ratio_calculator":{"post":{"operationId":"aspect_ratio_calculator","summary":"Simplifies a pixel width x height to a reduced integer aspect ratio (e.g. 1920x1080 -> 16:9), the","description":"Simplifies a pixel width x height to a reduced integer aspect ratio (e.g. 1920x1080 -> 16:9), the\n    decimal ratio, total pixels, and the closest well-known named ratio if any. Use for \"what ratio is\n    2560x1080\", \"is 3840x1600 21:9\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"width":{"description":"Pixel width.","exclusiveMinimum":0,"title":"Width","type":"integer"},"height":{"description":"Pixel height.","exclusiveMinimum":0,"title":"Height","type":"integer"}},"required":["width","height"],"title":"aspect_ratio_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/audio_format_info":{"post":{"operationId":"audio_format_info","summary":"Explains a home-theater audio format — whether it's channel-based (fixed channel count like 5.1/7.1) or","description":"Explains a home-theater audio format — whether it's channel-based (fixed channel count like 5.1/7.1) or\n    object-based (Dolby Atmos, DTS:X), its channel layout, and whether it's lossy or lossless. Use for \"what's\n    the difference between Dolby Atmos and 5.1\", \"is DTS:X the same as Dolby Atmos\", \"what is 7.1 surround\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"An audio format, e.g. 'Dolby Atmos', 'DTS:X', 'Dolby Digital', '5.1', '7.1', 'stereo', 'DTS-HD Master Audio'.","title":"Name","type":"string"}},"required":["name"],"title":"audio_format_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/room_acoustics_guide":{"post":{"operationId":"room_acoustics_guide","summary":"General home-theater room acoustic treatment basics: absorption vs. diffusion, first reflection points,","description":"General home-theater room acoustic treatment basics: absorption vs. diffusion, first reflection points,\n    bass traps, room modes/standing waves, and speaker/listening-position placement. Use for \"how do I treat my\n    home theater room\", \"what's a first reflection point\", \"why is my bass boomy in one spot\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An acoustics topic, e.g. 'absorption', 'diffusion', 'first reflection points', 'bass traps', 'room modes', 'speaker placement'. Omit to list them all.","title":"Topic"}},"title":"room_acoustics_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/troubleshooting_guide":{"post":{"operationId":"troubleshooting_guide","summary":"Step-by-step general troubleshooting for a specific A/V problem: no signal, lip-sync/audio-delay,","description":"Step-by-step general troubleshooting for a specific A/V problem: no signal, lip-sync/audio-delay,\n    HDMI handshake/HDCP errors, no audio, intermittent picture/sound dropouts, or ARC/eARC not working. Use for\n    \"my TV says no signal\", \"how do I fix audio out of sync\", \"why does my screen flash black\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue":{"description":"An A/V problem, e.g. 'no signal', 'lip sync', 'audio delay', 'hdmi handshake', 'no audio', 'dropouts', 'arc not working'.","title":"Issue","type":"string"}},"required":["issue"],"title":"troubleshooting_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/av_glossary":{"post":{"operationId":"av_glossary","summary":"Definitions of common A/V terms and abbreviations (HDCP, ARC, eARC, refresh rate, chroma subsampling,","description":"Definitions of common A/V terms and abbreviations (HDCP, ARC, eARC, refresh rate, chroma subsampling,\n    HDR, CEC, VRR, ALLM, upscaling, bitstream vs. PCM, damping factor, overscan, frame rate, dynamic range).\n    Use for \"what does HDCP mean\", \"what's chroma subsampling\", \"what's the difference between bitstream and\n    PCM\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up, e.g. 'HDCP', 'eARC', 'chroma subsampling'. Omit to list all.","title":"Term"}},"title":"av_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}