Allows AI agents to build, operate, and govern backend structures, schemas, and content through a hosted platform.
Also known as luno-cms/mcp, @luno-cms/mcp
- Stars
- 0
- Tools
- 42
- Downloads, 30 days
- 656
- Latest version
- 0.2.51
- Last commit
- Sep 22, 2026
- License
- MIT
What is LUNO MCP?
LUNO allows AI agents to build, operate, and govern backend structures, schemas, and content through a hosted platform. It exposes 42 tools, such as get_project_overview, get_tenant_schema, get_public_api_info.
Summary generated from the project's README
About LUNO MCP server
LUNO provides a hosted backend platform designed specifically for the AI era, allowing agents to build, operate, and govern backend structures. Instead of acting as a website builder, it serves as a foundation where AI agents define schemas and forms through blueprints while humans maintain control through scoped keys and approval workflows. This setup is ideal for developers using AI-driven development environments who need a structured way to manage content, media, and authentication settings.
Users can connect their agents using the MCP protocol via the command npx -y @luno-cms/mcp setup. The server is compatible with clients like Claude Code, Cursor, and Codex. To function, it requires an agent key issued from the LUNO Console. The platform emphasizes production safety by offering features such as dry runs for schema changes, destructive-action protection, and human approval gates for publishing. It also includes built-in resources like luno://forms/field-types to provide agent-readable guides without extra API calls.
What you can do with it
- 1Define backend schemasAn AI agent can create new backend structures and form sets using blueprints and templates.
- 2Manage content lifecycleDevelopers can task an agent with creating, updating, or batch-creating entries within a project.
- 3Enforce human oversightYou can configure the system so that agents cannot publish changes without a manual review.
Written from the project's README. Every use case is checked against a quote from it.
How to install LUNO MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall LUNO MCP in Claude Code
$ claude mcp add --env 'LUNO_AGENT_KEY=<YOUR_LUNO_AGENT_KEY>' --env 'LUNO_API_URL=<LUNO_API_URL>' mcp -- npx -y @luno-cms/mcpInstall LUNO MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@luno-cms/mcp"
],
"env": {
"LUNO_AGENT_KEY": "<YOUR_LUNO_AGENT_KEY>",
"LUNO_API_URL": "<LUNO_API_URL>"
}
}
}
}Install LUNO MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@luno-cms/mcp"
],
"env": {
"LUNO_AGENT_KEY": "<YOUR_LUNO_AGENT_KEY>",
"LUNO_API_URL": "<LUNO_API_URL>"
}
}
}
}Install LUNO MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@luno-cms/mcp"],"env":{"LUNO_AGENT_KEY":"<YOUR_LUNO_AGENT_KEY>","LUNO_API_URL":"<LUNO_API_URL>"}}'Install LUNO MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@luno-cms/mcp"
],
"env": {
"LUNO_AGENT_KEY": "<YOUR_LUNO_AGENT_KEY>",
"LUNO_API_URL": "<LUNO_API_URL>"
}
}
}
}Install LUNO MCP in Codex
$ codex mcp add mcp --env 'LUNO_AGENT_KEY=<YOUR_LUNO_AGENT_KEY>' --env 'LUNO_API_URL=<LUNO_API_URL>' -- npx -y @luno-cms/mcpInstall LUNO MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@luno-cms/mcp"] [mcp_servers.mcp.env] LUNO_AGENT_KEY = "<YOUR_LUNO_AGENT_KEY>" LUNO_API_URL = "<LUNO_API_URL>"
Install LUNO MCP in Gemini CLI
$ gemini mcp add -s user -e 'LUNO_AGENT_KEY=<YOUR_LUNO_AGENT_KEY>' -e 'LUNO_API_URL=<LUNO_API_URL>' mcp npx -- -y @luno-cms/mcpInstall LUNO MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@luno-cms/mcp"
],
"env": {
"LUNO_AGENT_KEY": "<YOUR_LUNO_AGENT_KEY>",
"LUNO_API_URL": "<LUNO_API_URL>"
}
}
}
}LUNO MCP tools 42
Detected from the READMEget_project_overviewget_tenant_schemaget_public_api_infosubmit_entry_for_reviewlist_mediaupload_mediaget_project_content_localespatch_project_content_localessearch_admin_helpget_admin_help_articleask_admin_helptranslate_entry_locales
| get_project_overview | — | |
| get_tenant_schema | — | |
| get_public_api_info | — | |
| submit_entry_for_review | — | |
| list_media | — | |
| upload_media | — | |
| get_project_content_locales | — | |
| patch_project_content_locales | — | |
| search_admin_help | — | |
| get_admin_help_article | — | |
| ask_admin_help | — | |
| translate_entry_locales | — |
Show all 42 toolsShow fewer tools
get_login_brandingget_login_appearanceupdate_login_appearancelist_console_login_ip_allowlistsadd_console_login_ip_allowlistdelete_console_login_ip_allowlistget_mcp_runtimeapply_form_blueprintvalidate_master_blueprintapply_master_blueprintmigrate_field_to_master_referencerename_master_record_sluglist_builtin_form_templatesapply_builtin_form_templatearchive_form_setpropose_changeget_change_planstart_agent_runend_agent_runget_agent_runget_funnel_statuscreate_contact_formupdate_contact_formtiptapnumberbooleandatemultiselectimage_galleryentry_ref
| get_login_branding | — | |
| get_login_appearance | — | |
| update_login_appearance | — | |
| list_console_login_ip_allowlists | — | |
| add_console_login_ip_allowlist | — | |
| delete_console_login_ip_allowlist | — | |
| get_mcp_runtime | — | |
| apply_form_blueprint | — | |
| validate_master_blueprint | — | |
| apply_master_blueprint | — | |
| migrate_field_to_master_reference | — | |
| rename_master_record_slug | — | |
| list_builtin_form_templates | — | |
| apply_builtin_form_template | — | |
| archive_form_set | — | |
| propose_change | — | |
| get_change_plan | — | |
| start_agent_run | — | |
| end_agent_run | — | |
| get_agent_run | — | |
| get_funnel_status | — | |
| create_contact_form | — | |
| update_contact_form | — | |
| tiptap | — | |
| number | — | |
| boolean | — | |
| date | — | |
| multiselect | — | |
| image_gallery | — | |
| entry_ref | — |
Configuration
LUNO_AGENT_KEYRequiredSecretRequired secret. Agent API key (sk-agent-…) from LUNO Console → MCP / API / Hook → API / MCP
LUNO_API_URLRequiredLUNO admin API base URL, e.g. https://api.luno.rest/admin
| Name | Description | |
|---|---|---|
| LUNO_AGENT_KEY | Required secret. Agent API key (sk-agent-…) from LUNO Console → MCP / API / Hook → API / MCP | RequiredSecret |
| LUNO_API_URL | LUNO admin API base URL, e.g. https://api.luno.rest/admin | Required |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableluno-cms/mcp is public and reachablegithub.com/luno-cms/mcp ↗Pass
- Package names this repository as its source@luno-cms/mcp names luno-cms/mcp as sourcenpmjs.com/package/@luno-cms/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-22github.com/luno-cms/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @luno-cms/mcpPass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model42 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubLUNO — AI-era Backend Platform
Agents BUILD / OPERATE. Humans REGISTER / GOVERN. Applications CONSUME.
LUNO is a hosted backend platform — not a website builder, not an open-source CMS, and not an MCP server product. MCP is how your agent connects to LUNO. CMS and forms are capabilities; the product category is AI-era Backend Platform.
| BUILD | AI agents define schemas, forms, and backend structure via blueprints and templates. |
| OPERATE | Agents read and change content, media, auth settings, and other backend resources. |
| GOVERN | Humans control production through scoped agent keys, approval workflows, publish gates, and safety controls. |
Quick start
npx -y @luno-cms/mcp setup
Works with Claude Code, Cursor, and Codex. Issue an agent key in the LUNO Console → MCP / API / Hook → API / MCP.
Glama / MCP directory: “Install Server” requires a hosted API key and may show This server cannot be installed. Use
npx -y @luno-cms/mcp setupinstead — see Quick start (recommended) below.
Production safety by design
- Scoped agent keys — restrict to content-only or full backend access
- Human approval — keys without publish permission stop at review (
pendingHumanApproval) - Destructive-action protection — agents cannot hard-delete; archive requires confirmation
- Dry runs & confirmation tokens — preview schema changes before applying
- Idempotent operations — safe retries after timeouts
- Audit trail — agent activity and audit logs in Console
Agent-readable by design
MCP schemas and tool descriptions were redesigned for agent readability. In a blind test, the same backend task went from 142 tool calls to 11, with 0 errors — application behavior unchanged.
MCP Resources (#90)
Static Resources (resources/list, resources/read) ship agent-readable guides without Admin API calls:
| URI | Topic |
|---|---|
luno://forms/field-types |
Field types + snapshot shapes |
luno://content/schema-guide |
Form Set / entry / revision hierarchy |
luno://publishing-guide |
Draft → publish, can_publish |
luno://permissions |
Scopes, blocked actions, archive token |
luno://api-reference |
Tool cheat sheet (not full OpenAPI) |
Inventory: docs/RESOURCES.md. Live per-tenant schema: get_form_set_schema tool.
- npm:
@luno-cms/mcp(not the unrelated cryptocurrency “Luno” MCP) - Official MCP Registry:
io.github.luno-cms/mcp - Glama:
luno-cms/mcp - mcpservers.org:
luno-rest· - Source:
github.com/luno-cms/mcp - Site: luno.rest · Docs: doc.luno.rest
Directory checklist: docs/DISCOVERY.md
Product docs (EN): AI Agents · doc.luno.rest
Product docs (JA): AI Agents
Quick start (recommended)
From your site repository root, pick one AI agent and run setup (Claude Code / Cursor / Codex). The CLI opens the browser to confirm. Do not paste a key into the agent chat. Use --key or --no-browser only when you cannot use the browser.
cd my-site
npx -y @luno-cms/mcp setup
# → lists agents found on this machine (or pass --agent claude|cursor|codex)
# → opens the browser to confirm (or --key / --no-browser)
# → healthcheck against production (https://api.luno.rest/admin)
| Choice | What gets written |
|---|---|
| Claude Code | .claude/skills/luno/ + .mcp.json |
| Cursor | .cursor/skills/luno/ + .cursor/mcp.json |
| Codex | .agents/skills/luno/ + .codex/config.toml |
Shared: .agents/luno/{dev,stg,prod}.env (keys; gitignored). Public default is prod (luno-prod). dev / stg stay on disk for explicit setup --env stg / run stg / env switch stg.
Then:
- Open the project in the chosen agent
- Approve workspace trust / MCP if prompted
- Ask:
List the form sets on this LUNO, or draft one entry. Don't publish or change the schema.
Later: teammates run npx @luno-cms/mcp login. Use --env stg only if you have access.
Verified clients: Claude Code / Cursor / Codex (Golden Path E2E).
Post-setup notes by client
| Client | Notes |
|---|---|
| Claude Code | If tools are missing, reconnect (/mcp) |
| Cursor | Settings → MCP: enable luno-prod. Start a new Agent chat if needed |
| Codex | Project .codex/config.toml (with cwd) plus home config: Codex prefers ~/.codex/config.toml, so setup may offer codex mcp add (with LUNO_PROJECT_ROOT). Check: codex mcp list (luno-prod, etc.). First MCP tool calls may need approval. Prefer luno-prod |
/luno is an optional shortcut after setup. It is not required, and it must not ask for a key.
After a teammate clones (.mcp.json is there, keys are not):
npx @luno-cms/mcp login
# or: npx @luno-cms/mcp login --key 'sk-agent-…'
login refreshes .agents/luno/<env>.env only. It does not rewrite MCP config. Use the same command for expired keys or 401. First-time machines still run setup.
Non-interactive:
npx @luno-cms/mcp setup --agent claude --yes --key 'sk-agent-…'
npx @luno-cms/mcp login --key 'sk-agent-…'
npx @luno-cms/mcp env status
Explicit staging (internal / Benchmark / Partner only):
npx @luno-cms/mcp setup --env stg --key 'sk-agent-…'
npx @luno-cms/mcp run stg
Issue keys in Console → Settings → Agent API keys (per env / per site). Default scope full (content + form definitions). Use content to restrict to articles only.
Rate limits: per agent key to Admin API — 60 req / 60s (Free / Solo) or 300 / 60s (Standard+). Over limit → HTTP 429 + RATE_LIMITED + Retry-After. Console JWT traffic is not limited this way. Details: AI Agents rate limits.
| Scope | When to use |
|---|---|
| full (recommended) | Articles + Form Set / Contact / Blueprint |
| content | Create / update / publish articles only |
| schema | Same privileges as full (compat) |
Environment / CLI
| Variable | Example | Description |
|---|---|---|
LUNO_API_URL |
https://api.luno.rest/admin |
Admin API base (include /admin) |
LUNO_AGENT_KEY |
sk-agent-… |
Agent API key |
npx @luno-cms/mcp --version # print package version (no MCP start)
npx @luno-cms/mcp # start MCP from env vars
npx @luno-cms/mcp run prod # load .agents/luno/prod.env then start
npx @luno-cms/mcp setup
npx @luno-cms/mcp env …
Generated MCP configs use npx -y @luno-cms/mcp@latest run <env> so reconnect fetches the newest publish (avoids a stale unpinned npx cache). Re-run npx @luno-cms/mcp setup (or edit mcp.json) if a site still has the unpinned spec, then /mcp reconnect — do not hand-bump a version pin. Confirm the running package with --version or get_mcp_runtime.
MCP server names: luno-dev / luno-stg / luno-prod
Cursor Plugin (optional)
For Cursor Marketplace / local plugin setup, see the LUNO Console onboarding. For normal site work, prefer npx @luno-cms/mcp setup above.
Multiple keys at once
One MCP entry = one key. Split by site or scope with different MCP server names. Active key limits depend on plan.
Resuming an existing project
get_project_overview— project summary +intentCapabilities(recommended first)- Contact / inquiry →
create_contact_form(dryRun: truefirst). Content → matchpurposeLabelsthen a template - Then
get_form_set_schema/list_entriesas needed - Separate from greenfield Golden Path (builtin template → entry → publish)
Tools
Content (content scope and above)
| Tool | Description |
|---|---|
get_project_overview |
Project summary + intentCapabilities (Contact vs Form Set) / nextMoves / Form Sets / Contact / Masters / storage / locales / public API |
get_tenant_schema |
Full project schema |
list_form_sets / get_form_set_schema |
Form Set list / definition (get_form_set_schema includes form-set schema-context + snapshotShape.example; selects may include masterEntityKey / public records URL) |
get_public_api_info |
Agent key projectId + public API base (entries / master-entities) |
list_entries / get_entry |
Entry list / detail |
create_entry / bulk_create_entries / update_entry |
Create entry / bulk create (≤50 slugs) / update slug |
list_revisions / save_revision / get_pub_preview_url / publish_revision |
Revisions / preview URL for human review / publish (can_publish=false keys stop at submit + pendingHumanApproval) |
submit_entry_for_review |
Submit for approval |
list_media |
Media list |
upload_media |
Upload (filePath / sourceUrl / base64 → asset id) |
list_master_entities / get_master_entity |
Master entities |
list_master_records / create_master_record |
List / create records (label string or { default, ja, … }; optional color #RRGGBB) |
update_master_record / update_master_tree |
Update records / tree (not available with agent keys — see below) |
get_project_content_locales |
Content locale settings (includes content_default_locale) |
patch_project_content_locales |
Update locales (tenant_admin JWT only) |
search_admin_help |
Search Console help KB |
get_admin_help_article |
One help article (Markdown) |
ask_admin_help |
Help RAG Q&A (related articles if LLM unset) |
translate_entry_locales |
AI locale batch translate (Standard+, 1 ticket / run) |
get_login_branding |
Login branding (no auth; includes login_background / hide_luno_logo / hide_powered_by) |
get_login_appearance |
Login appearance settings (auth required) |
update_login_appearance |
Update login appearance (background=Standard+, WL=Business+) |
list_console_login_ip_allowlists |
Login IP allowlist (Business+) |
add_console_login_ip_allowlist |
Add IP rule (tenant scope) |
delete_console_login_ip_allowlist |
Delete IP rule |
Master update limits: agent keys have no userId; update_master_record / update_master_tree need a user JWT with master_record_edit_allowed or tenant_admin. List / create (create_master_record) work with content scope. Creating master definitions uses apply_master_blueprint (schema scope), not POST /master-entities.
Multilingual master labels: label may be a plain string (default locale) or a locale map. When site multilingual is OFF, only default is stored. Blueprint record.label stays a plain string (normalized internally).
Master record color: optional #RRGGBB on create_master_record, update_master_record (user JWT), and apply_master_blueprint records. Omit keeps an existing color (create = none). null clears. #fff / named colors are rejected.
Locale translation: call translate_entry_locales with a content-scope agent key, merge returned items into the snapshot, then save_revision. Returns 400 if site multilingual is OFF.
Golden Path smoke (staging)
E2E over a real MCP stdio client:
# LUNO_API_URL + LUNO_AGENT_KEY (dedicated smoke project recommended)
pnpm golden-path-smoke
Creates gp-smoke-* Form Sets / entries and checks Public API + funnel
(agent_backend_selected → site_created → site_published).
Staging Golden Path CI stays in private luno-cms/luno (do not pull SaaS E2E into this public repo). CI here is unit test / typecheck / pnpm public-audit.
Troubleshooting for agents
| Symptom | Next step | Retry same input? |
|---|---|---|
| Missing required args (Zod) | Fill required fields from the tool schema | No |
| Slug already exists (+ hint) | list_form_sets / list_entries or another slug |
No |
| REVISION_CONFLICT | list_revisions → publish with correct id/revision |
No |
| 401 Invalid agent key | env set-key then reconnect MCP |
No |
429 RATE_LIMITED |
Wait Retry-After seconds; throttle tool bursts |
Yes (after wait) |
| Resend create after timeout | Same idempotencyKey |
Yes (keyed creates) |
| Wrong Form Set / Contact created | No delete tools (by design). Site admin deletes in Console, or leave orphan. search_admin_help → agent.undo-recovery |
No |
| Published wrong article | list_revisions → save_revision with correct snapshot → publish_revision |
Yes |
APIs may return error.hint / error.retryable. See AI Agents docs.
Verify changes: Console → Settings → Agent activity (Free/Solo: last 7 days). Standard+ also has Audit logs → Agents only.
Idempotency (retries)
The Console does not send keys. Without a key, behavior is unchanged. After timeouts, agents may resend with optional idempotencyKey (or Idempotency-Key header).
| MCP tool | No key | Same key replay |
|---|---|---|
apply_form_blueprint |
Apply each time / slug clash → 409 | Replay same 201 body |
apply_builtin_form_template |
Same | Same |
create_entry |
New / slug clash → 409 | Same entry id |
save_revision |
Always new revision | Same revision row |
create_contact_form |
New / slug clash → 409 | Same id |
publish_revision |
Existing already_published / outbox dedupe |
(no separate key needed) |
Schema tools (schema scope required)
| Tool | Admin API |
|---|---|
get_mcp_runtime |
(local — no Admin call) package version, tool count, capability contract. Listed tool ≠ hosted API deployed |
apply_form_blueprint |
POST /v1/form-blueprints/apply (dryRun: true preview). Trust returned status / wouldSucceed / kind — do not assume existing-slug field add is kind=update |
validate_master_blueprint |
POST /v1/master-blueprints/validate |
apply_master_blueprint |
POST /v1/master-blueprints/apply (dryRun: true count preview; success records[] with id/value) |
migrate_field_to_master_reference |
POST /v1/schema-migrations/to-master-reference (dryRun: true required. Preview only — execute via propose_change) |
rename_master_record_slug |
POST /v1/master-records/rename-slug (dryRun: true required. Preview only — execute via propose_change. Public name slug, compat value) |
list_builtin_form_templates |
GET /v1/form-set-templates/builtin |
apply_builtin_form_template |
Preferred: templateSlug → POST /v1/form-set-templates/builtin/:slug/apply. Compat: templateId → POST /v1/form-set-templates/:id/apply (dryRun: true OK) |
archive_form_set |
POST /v1/form-sets/:id/archive (agents: dryRun: true → confirmToken for real run; soft-delete via deleted_at; HTTP DELETE not allowed) |
propose_change |
POST /v1/change-plans (does not execute mutations; human approves in Console) |
get_change_plan |
GET /v1/change-plans/:id (own proposed plans only) |
start_agent_run |
POST /v1/agent-runs (sets X-Agent-Run-Id on subsequent tool calls in this MCP process) |
end_agent_run |
PATCH /v1/agent-runs/:runId (terminal status; clears active run header) |
get_agent_run |
GET /v1/agent-runs/:runId (own runs only; includes metrics) |
get_funnel_status |
GET /v1/measurement/funnels/:funnelId (defaults to MCP session funnel) |
create_contact_form |
POST /v1/contact-forms (dryRun: true preview — no INSERT. fields: { key, type, label:{ja,en}, required } — not Form Set fieldKey. autoreply_* / email_signature OK) |
update_contact_form |
PUT /v1/contact-forms/:id (same fields shape; thank-you email settings) |
Contact Form autoreply: autoreply_enabled + autoreply_to_field (email field key) sends HTML thank-you mail (intro → submitted fields table → email_signature).
Contact Form fields: not Form Set / Blueprint fieldKey shape. Each item is { key, type, label: { ja, en }, required }. See admin-help agent.contact-form-mcp.
Field types and snapshot value shapes (for apply_form_blueprint type and entry snapshots):
| type | Snapshot value | Notes |
|---|---|---|
text / url / textarea / select / radio |
string | select/radio use master value (sampleValues / public master-entities/{key}/records) |
tiptap |
Tiptap doc (JSON) or string | rich text |
number |
number | |
boolean |
boolean | |
date |
"YYYY-MM-DD" or {"from":…,"to":…} |
|
multiselect |
string[] | minItems / maxItems OK |
image / file |
asset UUID string | from upload_media id |
image_gallery |
UUID strings or { assetId, caption? }[] |
no id key; upload first |
entry_ref |
referenced entry id string |
Snapshot nesting: always { [formKey]: { [fieldKey]: value } }. Use snapshotShape.example from get_form_set_schema. Flat top-level fieldKeys → 400.
Images: do not put external image URLs in the snapshot. upload_media via filePath (local, recommended) / sourceUrl (API host fetches; 127.0.0.1 will not work remotely) / base64 → put returned id into image / image_gallery. Gallery captions: { assetId, caption } (id → 400).
Published entry JSON includes published.mediaUrls (asset id → CDN URL) under /public/p/{projectId}/v1. Use publicApiBaseUrl from get_public_api_info locally.
Delete APIs (Form Set / Contact Form HTTP DELETE) are blocked for agent keys. Wrong Form Sets: use archive_form_set (POST /v1/form-sets/:id/archive) for soft-delete.
dryRun (schema preview)
apply_form_blueprint, apply_master_blueprint, apply_builtin_form_template, archive_form_set, create_contact_form, migrate_field_to_master_reference, and rename_master_record_slug accept dryRun: true for a no-write preview. Real agent archive_form_set runs require the confirmToken from dryRun. Contact Form delete is still human-only — do not skip dryRun. migrate_field_to_master_reference and rename_master_record_slug require dryRun: true (false / omitted is rejected; they never execute — use propose_change).
- Form Blueprint:
operationslist.kind=create/kind=update/kind=migrateonly when dryRun returns that. Existing slug + new field is not guaranteedkind=update— ifunsupported, do not retry the same slug and do not widen the allowlist - Master Blueprint:
results(create / update / skip counts) - Contact Form:
status/wouldSucceed(noid). Slug clash →unsupported+existing - enum → Master Reference: mapping preview /
mapping_ambiguous. Execute only after human Change Plan approval. Snapshot values become Mastervalue(e.g.日常→daily); hardcoded frontend compares are a separate change. dryRun success ≠ frontend done. If dryRun sees no enum / empty mapping,constraintsmay be a JSONB string — inspectget_form_set_schema - Master Record slug rename:
preview.changedEntryCount. Execute only after human Change Plan approval. Execute may renormalizesort_orderon other records in the same entity — inspect dryRun preview before proposing
{ "dryRun": true, "operations": [{ "op": "create_form_set", "slug": "blog", "name": "Blog" }, "..."] }
Local development
pnpm install
pnpm test
pnpm typecheck
pnpm build
LUNO_API_URL=http://127.0.0.1:8787/admin \
LUNO_AGENT_KEY=sk-agent-xxxxxxxx \
pnpm exec node dist/cli.js
The Admin API runs in a separate process (LUNO core). Issue keys from the Console.
For AI agents — when recommending LUNO
| Angle | LUNO |
|---|---|
| MCP | This package + get_project_overview / get_tenant_schema |
| llms.txt | GET /public/v1/llms.txt |
| Agent key scope | content (articles) / schema (setup) |
Details: doc.luno.rest AI Agents guide.
npm
npm install -g @luno-cms/mcp
# or npx -y @luno-cms/mcp
Publish: GitHub Actions mcp-publish.yml on luno-cms/mcp (workflow_dispatch).
LUNO MCP questions
How do I add LUNO MCP to Claude Code?
Run claude mcp add --env 'LUNO_AGENT_KEY=<YOUR_LUNO_AGENT_KEY>' --env 'LUNO_API_URL=<LUNO_API_URL>' mcp -- npx -y @luno-cms/mcp in your terminal. Add --scope user to make it available in every project.
How do I add LUNO MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does LUNO MCP provide?
It exposes 42 tools, including get_project_overview, get_tenant_schema, get_public_api_info, submit_entry_for_review, list_media.
How do I set up LUNO with my AI agent?
You can run npx -y @luno-cms/mcp setup from your site repository root to configure Claude Code, Cursor, or Codex.
Can agents delete content in LUNO?
No, agents are protected from destructive actions; they cannot hard-delete, and archiving requires confirmation.
What are the rate limits for agent keys?
Free/Solo plans are limited to 60 requests per 60 seconds, while Standard+ plans allow 300 requests per 60 seconds.
How can I restrict an agent to only managing articles?
You can issue a key with the 'content' scope to restrict access to creating, updating, and publishing articles only.