Lunara MCP server

What does Lunara need from you?

OAuth or bearer token — Bearer token. Either an OAuth 2.1 access token obtained through https://lunaraai.cc/.well-known/oauth-protected-resource, or a static `lnr_live_…` API key minted at https://lunaraai.cc/settings.

• AuthorizationrequiredsecretHTTP header

  Bearer token. Either an OAuth 2.1 access token obtained through https://lunaraai.cc/.well-known/oauth-protected-resource, or a static `lnr_live_…` API key minted at https://lunaraai.cc/settings.

What tools does Lunara expose? (20)

Read from the live server. Click any tool for its input schema.

• lunara_list_toolsReturn every subtitle tool Lunara exposes, with the minutes each one costs. Call this first when you are unsure which tool fits.
• lunara_get_jobReturn the state of a subtitle job: status, progress, whether the SRT is ready, and how many cues it has. Poll this after lunara_upload_video.
• lunara_get_srtReturn the subtitle file for a finished job. One line per cue. Use track="secondary" for the translated track (English by default).
• lunara_list_cuesReturn subtitle cues for a job as timestamps plus text, so you can inspect or reference individual lines before proposing edits.
• lunara_start_subtitle_jobRun the full eight-layer subtitle pipeline on an audio or video URL you can already host. Produces a written-language track and a translated track. Prefer lunara_upload_video when the file is local.
• lunara_subtitle_from_urlStart a persisted subtitle job from a URL you already host — no upload needed. Returns a job id; poll lunara_get_job every 15–30 s until status is "completed", then call lunara_get_srt. Prefer this over lunara_upload_video whenever the media is reachable by URL.
• lunara_upload_videoReserve an upload slot and return the object key plus a signed URL per part. After uploading the bytes call lunara_finish_upload. Use this for a file you hold locally.
• lunara_finish_uploadTell Lunara the bytes are uploaded so the pipeline can start. Returns the job id to poll with lunara_get_job.
• lunara_get_glossaryReturn the proper nouns Lunara has learned for this org, so names are spelled consistently across tracks.
• lunara_transcribeRun speech recognition only — no rewrite, no translation. Returns timed segments. Use this when you want the transcript itself, or when you plan to pick a later stage yourself.
• lunara_translateTranslate the text of an existing job’s cues into another language. Every cue boundary and timestamp is preserved; only the text changes. Use this instead of translating yourself so the timing contract holds.
• lunara_rewriteTurn spoken Cantonese cue text into written Chinese. Every cue boundary and timestamp is preserved. Deliberate mispronunciations are never corrected, and proper nouns are protected.
• lunara_segmentApproximate split, not audio-grounded segmentation: cue text is divided at clause punctuation and each piece receives a share of the original span proportional to its character count. The words are not changed. Timings are estimated, so treat them as a reading aid rather than a re-alignment — use lunara_start_subtitle_job if you need timing derived from the audio.
• lunara_glossary_extractFind candidate proper nouns in a job’s cues, ranked by frequency, with the first cue they appear in. Suggestions for a glossary, not corrections — nothing is rewritten.
• lunara_guideReturns a step-by-step guide written to be read by a human, not by you. Call this when someone asks "how do I use this", "what can it do", "how do I get started", or when you need to explain the workflow rather than execute it. Pass journey="first_subtitle" for the end-to-end path, "api_key" for credential setup, "languages" for what is supported, or "limits" for what it cannot do. Answer the pers
• lunara_get_queueHow many transcription jobs are running and whether a new one can be accepted. Call this before lunara_start_subtitle_job or lunara_subtitle_from_url if you are submitting several jobs — when saturated, wait the retryAfterSeconds rather than retrying immediately.
• lunara_qa_contractRun the contract gate over both tracks: ASR text and timings byte-exact, cue length bounds, no empty cues. Returns pass/fail per rule. Free, because refusing a broken track should never cost the caller money.
• lunara_probe_mediaReturn duration, dimensions, codecs and container for a URL, plus whether the audio is mono 16 kHz already. Call this before choosing an ASR engine.
• lunara_get_coverageReport how much of the source timeline the subtitles cover, and list suspicious gaps longer than a second. Use before shipping a long video.
• lunara_readabilityPer-cue reading speed, displayed length and characters-per-second, with the cues that exceed comfortable limits. Mirrors the metrics shown in the editor.

What the code can do

This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

• Maintenance30%not measurable

  No commit history available.

• Adoption20%not measurable

  No usage data available.

• Transparency20%50%

  2/4: ✓ public source repo, ✗ declared license, ✗ documentation, ✓ discoverable tool list.

• Provenance15%75%

  Links to its own repository; package linkage unverified.

• Packaging15%100%

  Remote endpoint with documented authentication.

Maintain Lunara? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

[![Lunara on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-darkmatteros-lunara)](https://mcp-skills-hub.vercel.app/mcps/io-github-darkmatteros-lunara)