MCP server

Read from the package source without running it. The installed server may list more.

• add_console_login_ip_allowlist

  管理画面ログイン IP 許可ルールを追加（Business+・tenant スコープ）。必須: projectId（プロジェクト UUID）, cidr。

• apply_builtin_form_template

  Builtin フォームテンプレから新規 Form Set を作成（schema/full）。必須: slug, name。テンプレ指定は templateSlug（list_builtin_form_templates の slug・推奨。purposeLabels で選ぶ）または templateId（DB テンプレ UUID）のどちらか必須。任意: description, dryRun, idempotencyKey。create のみ（既存 slug の migrate/update は apply_form_blueprint）。お問い合わせには使わない。返却 id を formSetId に使う。詳細: agent.builtin-form-templates。

• apply_form_blueprint
• apply_master_blueprint

  Master Blueprint を一括 upsert（schema/full）。必須: entities。任意: dryRun, publish（true でサイトに反映し公開マスタ API に載る。省略時は未反映）。各 record の並びは sort_order / sortOrder。任意 color は #RRGGBB（省略は既存色を維持、null で消す）。エージェントキーでは update_master_record 不可のためここで正しい sort_order / color を渡す。詳細: agent.master-blueprint-mcp, luno://content/schema-guide

• archive_form_set

  Form Set をアーカイブ（soft-delete / deleted_at。schema/full）。hard delete ではない。必須: formSetId。エージェントは先に dryRun: true で slug / entryCount / confirmToken / restore を取得し、本実行で confirmToken を渡す（トークンなしは 400）。型変更のために使わない。復元は人間の JWT のみ（POST /admin/v1/form-sets/{id}/restore。エージェントは 403 restore_requires_human_jwt）。返却の restore に consolePath / restoreApi / helpId / constraints（ウィジェットは戻らない）。人間の Console DELETE は従来どおり。Co

• ask_admin_help

  LUNO の使い方を自然言語で質問（RAG）。必須: question。任意: locale。snapshot / 公開 API / Blueprint は category agent を参照。502 / truncated はリトライ可。繰り返すなら search_admin_help / get_admin_help_article。本ツールはホスト LLM 依存で不安定なことがある。

• bulk_create_entrieswrite action

  Form Set 内にエントリを最大 50 件一括作成（slug のみ。本文は save_revision）。必須: formSetId, items[{ slug }]。任意: idempotencyKey（バッチ全体の冪等リプレイ）。各 item は独立に成功/失敗（slug 衝突は当該 item のみ failed）。N×create_entry の代わりに 1 ツールコール。削除の一括は不可（agent.mcp-security-permissions）。

• create_contact_formwrite action

  お問い合わせ / contact / inquiry 用。Contact Form を新規作成（schema/full。削除は不可）。Form Set テンプレや apply_form_blueprint は使わない。必須: slug, name, recipient_email（ユーザーから聞く）。任意: fields, autoreply_*, email_signature, dryRun, idempotencyKey。fields は Form Set の fieldKey 形ではない。各要素は { key, type, label:{ja,en}, required }。必ず先に dryRun: true（作成せず status/wouldSucceed）。slug 衝突は dryRun なら unsupported + existing、execute は 409。同じ sl

• create_entrywrite action

  エントリを新規作成（本文は含めない。続けて save_revision → get_pub_preview_url → publish_revision）。必須: formSetId（UUID）, slug（エントリの URL スラッグ）。任意: idempotencyKey（同一キー再送で同じ id）。返却 id を entryId に使う。

• create_master_recordwrite action

  マスタレコードを新規作成（content 可）。必須: entityId, label（string または locale map）。任意: value, sortOrder, parentRecordId, data, color（#RRGGBB）。並び・色の一括投入は apply_master_blueprint 推奨。

• delete_console_login_ip_allowlistwrite action

  管理画面ログイン IP 許可ルールを削除（Business+）。必須: ruleId（list_console_login_ip_allowlists の id）。

• end_agent_runwrite action

  Agent Run を終了（schema/full）。必須: runId, status（completed / failed / cancelled）。start_agent_run の agentRun.id を渡す。メトリクス（auditLogCount 等）を返す。

• get_admin_help_article

  管理画面ヘルプ記事 1 件の本文。必須: articleId（search_admin_help の id。例: content.publish-workflow, agent.publish-revision）。

• get_agent_runwrite action

  Agent Run の状態・メトリクスを取得（schema/full）。必須: runId。自分が開始した run のみ（他キーは 403）。

• get_change_plan

  Change Plan の状態を取得（schema/full）。必須: planId（propose_change の changePlan.id）。自分が提案した plan のみ。承認・却下・実行は Human Console のみ。

• get_entry

  エントリ 1 件。必須: formSetId, entryId（いずれも UUID）。

• get_form_set_schema

  1 つの Form Set のスキーマ + save_revision 用 snapshotShape。select/radio/multiselect には masterEntityKey・sampleValues・公開 records URL を付与。保存前に必ず確認する。必須: formSetId（UUID。Form Set の slug ではない。list_form_sets / apply_* の id）。

• get_funnel_status

  MCP Private Beta 計測ファネルを再構成。任意: funnelId（省略時は当セッション / LUNO_FUNNEL_ID）。詳細: agent.measurement-funnel

• get_login_appearance

  管理画面ログインの見た目設定を取得（認証要・引数なし）。背景=Standard+、WL=Business+。

• get_login_branding

  管理画面ログイン用ブランド取得（認証不要）。任意: projectId（省略時はエージェントキーのプロジェクト）。branding_tier / login_background / hide_* を返す。

• get_master_entity

  マスタエンティティ 1 件。必須: entityId（UUID。list_master_entities の id）。

• get_mcp_runtime

  この MCP パッケージの実行時情報（引数なし・LUNO API は呼ばない）。mcpVersion / toolCount / contract（tool→Admin API）。ツールが載っていてもホスト API が未デプロイのことがある。404 なら API が古い。代替 mutation を発明しない。詳細: luno://mcp/runtime。

• get_project_content_locales

  サイトのコンテンツ多言語設定を取得（引数なし）。有効/無効・content_locales・content_default_locale。

• get_project_overview

  既存プロジェクト再開時の最初の一手。intentCapabilities（ユーザー意図→プロダクト。お問い合わせは create_contact_form。お知らせ/ブログは purposeLabels で templateSlug）・nextMoves・hints.intent・Form Sets・Contact Forms・Masters・quota・locales・公開 API ベースを返す。空プロジェクトでも Contact を Form Set テンプレに落とさない。権限不足は available:false。MCP パッケージ版と API 契約は get_mcp_runtime（引数なし・LUNO 非呼び出し。ツール一覧 ≠ API デプロイ済み）。詳細: agent.discover。引数なし。

• get_pub_preview_url

  下書き/承認待ちリビジョンのプレビュー URL を取得（POST pub-preview-url）。必須: formSetId, entryId, revisionRowId（= save_revision の id）。任意: target（external=外部サイトテンプレ優先・既定, luno=LUNO ホスト）。返却 url を人間がブラウザで開いて確認。続けて publish_revision（can_publish=false なら pendingHumanApproval で人間承認）。未公開は Standard 以上プラン。詳細: luno://publishing-guide / agent.publish-revision。

• get_public_api_info

  エージェントキーのプロジェクト向け公開 API ベース URL を返す。引数なし。ローカルでは /public/p/{projectId}/v1 を使う（Host ベース /public/v1 は DEFAULT_TENANT_ID に落ちる）。

• get_tenant_schema

  操作中プロジェクトのフォームセット・フィールド定義を一括取得する。引数なし。

• list_builtin_form_templates

  LUNO 公式 Form Set スターター一覧（引数なし）。purposeLabels（ja/en。お知らせ・ブログ等）で用途をマッチし、返却 slug を apply_builtin_form_template の templateSlug に使う。slug を暗記しない。お問い合わせはここに無い。create_contact_form / get_project_overview.intentCapabilities を使う。詳細: agent.builtin-form-templates

• list_console_login_ip_allowlists

  管理画面ログイン IP 許可リスト一覧（Business+・引数なし）。

• list_entries

  Form Set 内のエントリ一覧。必須: formSetId（UUID）。返却 item.id を entryId に使う。

• list_form_sets

  Form Set 一覧を取得する。引数なし。各 item の id（UUID）を他ツールの formSetId に使う（slug ではない）。

• list_master_entities

  マスタエンティティ一覧（引数なし。key / hierarchical / record_count 含む）。item.id を entityId に使う。

• list_master_records

  マスタレコード一覧（label は locale map。階層時は parent_record_id）。必須: entityId。任意: q（検索）。

• list_media

  アップロード済みメディア（アセット）一覧。任意: limit（1–100、既定 30）。

• list_revisions

  エントリのリビジョン一覧。必須: formSetId, entryId。各 item の id / revision を publish_revision に渡す。

• migrate_field_to_master_reference
• patch_project_content_localeswrite action

  サイトのコンテンツ多言語設定を更新（tenant_admin JWT のみ。エージェントキー不可）。任意: contentLocalesEnabled, contentDefaultLocale, contentLocales。

• propose_change

  複数ステップの構造変更を Change Plan として提案（schema/full）。必須: goal, risk, steps（各 step に dry_run + mutation.body）。本ツールは mutations を実行しない。Human が Console で承認するまで pending_approval。先に apply_* / migrate_field_to_master_reference / rename_master_record_slug を dryRun: true で呼び、返却を steps[].dry_run.raw に格納し、本実行用 body を mutation.body に入れる。action は apply_form_blueprint / apply_builtin_form_template / apply_master_bluepri

• publish_revisionwrite action

  リビジョンを公開（1 回で draft→submit→approve。サーバー /publish が中間 revision +1 を吸収）。必須: formSetId, entryId, revisionRowId（= save_revision の id）, revision（= save_revision の revision。save 直後の番号で可）。任意: publishAt（予約公開 ISO8601）。can_publish=false のキーは submit までで止まり pendingHumanApproval: true を返す（人間が Console で承認）。詳細: agent.publish-revision / agent.mcp-security-permissions

• rename_master_record_slug

  Master Record の公開 identifier（slug。互換キー value）をリネームするプレビュー（schema/full）。必須: masterEntityKey, dryRun（true のみ）, slug または value, recordId または currentSlug/currentValue。このツールは書き込まない。dryRun: false / 省略は拒否し API を呼ばない。実行は propose_change(action: rename_master_record_slug)。update_master_record の value PATCH は使わない（snapshot が切れ、エージェントキーは 401）。承認後は master_records.value と参照 Field の snapshot を同時に書き換える。execute（Cha

• save_revision

  エントリ本文を新しい下書きリビジョンとして保存。必須: formSetId, entryId, snapshot。snapshot は { [formKey]: { [fieldKey]: value } }（フォームキー配下にネスト）。フラットな field_key トップレベルは 400。任意: idempotencyKey。返却の id → publish_revision の revisionRowId、revision → publish_revision の revision。形は get_form_set_schema または luno://content/schema-guide。

• search_admin_help

  ヘルプ KB 検索。必須: q。任意: locale（ja|en）, limit（既定 20）。category agent（snapshot / Form Blueprint / 公開 API / publish_revision）もヒット。

• start_agent_runwrite action

  エージェントタスクの Run を開始（schema/full）。必須: goal。任意: clientLabel（cursor / claude-code / mcp 等）。返却 agentRun.id を以降のツール呼び出しに X-Agent-Run-Id として自動付与（本 MCP セッション内）。詳細: settings.agent-activity / agent.mcp-security-permissions

• submit_entry_for_reviewwrite action

  指定リビジョンを承認申請する（公開まで一括したい場合は publish_revision を優先）。必須: formSetId, entryId, revisionRowId（= save_revision の id）, revision（= save_revision の revision）。

• translate_entry_locales

  text/textarea/tiptap をソース言語から他ロケールへ AI 翻訳（Standard+・AI チケット 1/回）。必須: sourceLocale, targetLocales（1–3）, fields（各 formKey/fieldKey/type/sourceText）。返却 items を snapshot にマージして save_revision。

• update_contact_formwrite action

  Contact Form を更新（PUT・schema/full。GET した全フィールドを body に含める）。必須: formId（Contact Form UUID）, slug, name, recipient_email, fields。任意: autoreply_*, email_signature。fields は { key, type, label:{ja,en}, required }[]（Form Set の fieldKey ではない）。詳細: agent.contact-form-mcp。

• update_entrywrite action

  エントリの slug を更新。必須: formSetId, entryId, slug。

• update_login_appearancewrite action

  管理画面ログインの見た目を更新。任意（1 つ以上推奨）: adminLoginBackground（cosmic|gradient|plain|none・Standard+）, adminLoginHideLunoLogo, adminLoginHidePoweredBy（Business+）。

• update_master_recordwrite action

  マスタレコードを更新。必須: entityId, recordId。任意: label, value, sortOrder, parentRecordId, data, color（#RRGGBB。null で消す）。**エージェント API キーでは不可**（401 — ユーザ JWT + 編集権限が必要）。identifier（slug / value）の変更は rename_master_record_slug → propose_change。並び替え・色の一括は apply_master_blueprint を使う。

• update_master_treewrite action

  階層マスタの親子・並び順を一括更新。必須: entityId, updates（全レコードを含める配列。各要素に id, parent_record_id, sort_order）。エージェントキーでは 403。

• upload_mediawrite action

  メディアライブラリへ画像/ファイルをアップロード（POST /v1/media）。必須（いずれか一方）: sourceUrl / base64 / filePath（ローカルパス推奨）。任意: filename, mimeType, folderId。返却 id（UUID）を image / image_gallery に入れる（luno://content/schema-guide）。外部 URL を snapshot に直書きしない。stg/prod へローカル画像を上げるときは filePath（sourceUrl の 127.0.0.1 は届かない）。

• validate_master_blueprint

  Master Blueprint を検証（schema/full）。必須: entities（1 件以上の配列）。各 entity: key, name, records[{ value, label, sort_order }]。適用はしない。詳細: agent.master-blueprint-mcp, luno://content/schema-guide。

• Code scan79 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 7 days ago15/15
• Maintainer identityregistry namespace matches repository owner7/10

MCP: common questions

Is MCP server safe?

Mostly: it is graded B (82/100). Read the MCP safety report

How do I install MCP?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does MCP need an API key?

Yes. The registry entry asks for LUNO_AGENT_KEY.

Is MCP maintained?

The last commit was 9 days ago (2026-09-12). The latest release is v0.2.50.