Read additional metadata/enum/grid endpoints (e.g. bouquets, EPG grabbers, stream profiles, scanfiles, orbital positions). Mutating endpoints are rejected. API paths are relative without '/api/'; pagination can be supplied in parameters.

Apply a reviewed plan from this MCP process; previews by default.

Plans expire after 15 minutes and actual executions consume the ID. Invented, expired or stale plans are rejected. Rechecks inventory and node fields, refuses active inputs/subscriptions, and attempts guarded rollback on a partial failure. Keep the returned recovery_snapshot; this is not an atomic transaction/full backup.

Assign advertised EPG source IDs to a channel; add preserves existing sources.

Source IDs are enum keys from get_field_options(channel_uuid, 'epggrab'), often module/channel strings rather than UUIDs. Empty replace explicitly clears.

Assign networks to the exact frontend or satellite-input node that owns the field.

For DVB-C/T use frontend.networks. For DVB-S inspect the hardware tree: networks or network_a/network_aa etc. may live on satellite configuration/input nodes. Use field options to match supported network types. 'add' preserves existing assignments, 'replace' replaces them, 'remove' removes only the listed networks.

Add, replace or remove a channel's service mappings, preserving others in add mode.

Read all channels/services and report duplicate names, HD/SD candidates and problems.

Regional names remain distinct. HD suggestions are name hints, not proof that two services carry the same programme. No automatic merging, numbering or deletion.

Create a channel: name, number, services UUID array, tags, EPG settings, etc.

Create a channel tag/group using fields from the channeltag class schema.

Create a named DVR profile, with storage/padding/retention fields from dvr_config.

Create an automatic series/title rule or recurring timer. Inspect the corresponding dvr_autorec/dvr_timerec class schema first; rule times use Tvheadend's native units. Edit/disable rules with update_node, delete them with delete_node.

Create a mux with network-specific tuning fields (symbolrate, FEC, PLP/PLS, etc.).

frequency_hz is always Hz: converted to native kHz for DVB-S/S2, Hz for DVB-C/T. Alternatively pass settings.frequency in Tvheadend's NATIVE units. Do not pass both. symbolrate is symbols/second, not ksymbols/second. Inspect mux_schema first.

Create a network using a class/schema from network_types.

Pass networkname, enabled and delivery-specific fields such as orbital_pos or scanfile as supported by this build. Existing networks are never silently reused.

Create a manual DVR timer. start_time/stop_time: ISO 8601 with explicit UTC offset.

extra accepts recording fields such as start_extra/stop_extra (minutes), pri, comment. Core channel/title/time/profile fields cannot be overridden via extra.

Delete a DVB/channel/rule/profile object and possibly dependent objects.

For DVR recordings use recording_action instead. Hardware availability is managed by the OS/Tvheadend. Network deletion can cascade to its muxes and services.

Inspect network assignment, scan failures and active inputs without starting a scan.

Network/mux counts are paginated; hardware is traversed recursively. A missing assignment or repeated scan failures is reported as evidence, not a guessed diagnosis.

Trigger Tvheadend's SAT>IP server discovery. Requires SAT>IP client support.

Measure time coverage, gaps and description presence for the next 1..168 hours.

Defaults to all enabled channels (maximum 500); explicit selection includes disabled channels. Overlapping events are counted once. Incomplete reads report errors rather than claiming full coverage. Does not tune a receiver or prove reception quality.

Read global EPG grabber settings and their live metadata, including schedules.

Resolve a field's static or API-backed enum: networks, LNB types, switches, etc.

Inspect one object's current values and metadata, including advanced/expert fields.

Get fields/types/defaults/options for a class found via list_classes or hardware_tree.

List adapters, frontends, satellite inputs, LNBs, switches, rotors and Unicable nodes.

uuid='root' lists adapters; a device UUID lists its children. recursive=true expands children, with their actual UUIDs, settings, descriptions and option metadata. Physical tuners are discovered by Tvheadend/its drivers, not created by this tool.

List channel groups/tags. Edit membership through channel.tags using update_node.

List all accessible channels, including disabled ones, with service and EPG mappings.

Discover available Tvheadend class names, optionally filtering name/caption.

List DVR profiles, output directories, padding and retention settings.

List automatic EPG recording rules (autorec) or recurring clock timers (timerec).

List native OTA/internal/external grabber modules, UUIDs and enabled status.

List EPG source channels, module IDs and existing Tvheadend channel mappings.

List muxes including scan state/result; optionally filter by network UUID.

List networks with UUID, delivery system, enabled state, scan queue and counts.

List DVR entries: upcoming includes active recordings; paginate using total/start.

List discovered services including disabled/unverified ones, encryption and mappings.

Start Tvheadend's native service-to-channel mapper for explicit service UUIDs.

Optional fields: encrypted, merge_same_name, check_availability, type_tags, etc. Uses service/mapper/save, which starts the mapper; there is no mapper/start API. Empty selection is rejected. Monitor mapper_status and list_channels afterwards.

Read service mapper success/failure counters and mapper configuration/options.

Read network-specific mux fields, tuning parameters and modulation/FEC enums.

List creatable DVB-S/C/T, ATSC, ISDB and IPTV network classes and their schemas.

Preview an explicit channel merge, retaining target name/number and unioning mappings.

Source channels are disabled, never deleted. DVR references and bouquet-managed sources block the plan. Regional/name mismatches require explicit verification. Returns a 15-minute plan_id for apply_maintenance_plan; does not change configuration.

Preview migration to an existing scanned DVB network, preserving channel UUIDs.

Reassign tuner inputs, replace mapped services only by unique ONID/TSID/SID matches, then disable source networks. No object deletion or unsupported mux movement. Different delivery systems/satellite positions and missing matches block execution.

Preview or run a bounded service MPEG-TS test (1..30 seconds, at most 64 MiB).

Without tuner_uuid, Tvheadend selects the receiver. An explicit frontend UUID temporarily isolates that tuner by disabling all competing enabled frontends. Isolation requires an idle server/no imminent DVR, journals prior settings and restores them on completion, error or cancellation. Save the preview snapshot. Process/host crashes require inspection via reception_recoveries and explicit restore. Active probing is blocked in read-only mode, including GET-only stream tests.

Read pending tuner-isolation recovery journals for this Tvheadend URL.

Normally probes restore settings and remove journals. After a process/host crash, inspect the recorded snapshot and current hardware, then use restore_snapshot. This tool never changes settings or reads files outside the configured state folder.

stop finishes an active recording; cancel cancels a timer/active recording.

remove_files PERMANENTLY DELETES the recording files through Tvheadend's remove endpoint. Use only when the user explicitly requests deletion of recordings.

Restore a snapshot's fields to EXISTING nodes. Default previews the changes.

All nodes are validated before the first write. Restore is sequential, not atomic; partial failures report completed/remaining UUIDs. Topology changes can invalidate child UUIDs; prefer restoring only the fields you actually changed.

Queue a service scan for selected networks; returns immediately.

Monitor list_networks.scanq_length and list_muxes.scan_state/scan_result. Scans use tuner capacity. For one mux, update_node with its schema's scan_state.

Record an EPG eventId; config_uuid='' selects Tvheadend's default DVR profile.

Search upcoming EPG programmes; query is a Tvheadend regular expression.

Results contain eventId for schedule_recording. Optional EPG-specific grid filters support time bounds; timestamps are Unix seconds. fulltext includes descriptions.

Export selected objects' writable, readable fields as a JSON change snapshot.

Save the returned JSON locally. This is NOT a complete Tvheadend backup: it cannot recreate deleted nodes, recordings or hardware; excludes secrets and write-once fields.

Read server version, active tuners/signals and subscriptions, with permission errors.

Stop a running automatic service-to-channel mapping operation.

Queue OTA collection or rerun enabled internal grabbers; collection is asynchronous.

OTA delay: 1..604800 seconds. Internal grabbers run immediately (delay must be 1). External XMLTV socket imports are not triggered by this endpoint.

Update global EPG fields using epggrab/config/save and the running build's schema.

Read get_epg_config first. Use the actual cron/OTA/save fields it advertises. This does not install grabbers or upload XMLTV data.

Configure an installed grabber module, e.g. enabled/priority, using its live fields.

Update any API-exposed tuner, LNB, DiSEqC, Unicable, network, mux, service, channel, EPG, bouquet or DVR object. Inspect get_node/get_field_options first.

Uses actual field IDs and native units, validates unknown/read-only fields, preserves unspecified fields; arrays REPLACE existing arrays. dry_run previews. After satconf/lnb_type/switch_type/en50494_type changes, re-read hardware_tree: child nodes may have been recreated. No hard-coded limits on expert settings.