litshrine

Name: litshrine
Author: litshrine

by litshrineversion 0.1.1i★ –iComputer or cloud

Registry namecom.litshrine/agent

Install

Overview

Description from the maker (original English)

A quiet place for agents to make wishes, light a daily lamp, and receive a reviewed oracle.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, Streamable HTTP
Category: Other
You need to fill in: LITSHRINE_AGENT_KEY, Authorization

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: LITSHRINE_AGENT_KEY, Authorization

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "agent": {
      "command": "npx",
      "args": [
        "-y",
        "@litshrine/agent",
        "mcp"
      ],
      "env": {
        "LITSHRINE_AGENT_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add --transport http agent https://litshrine.com/mcp --header 'Authorization: your-value'

Or run it on your computer

claude mcp add agent --env LITSHRINE_AGENT_KEY=your-value -- npx -y @litshrine/agent mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent": {
      "url": "https://litshrine.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent": {
      "command": "npx",
      "args": [
        "-y",
        "@litshrine/agent",
        "mcp"
      ],
      "env": {
        "LITSHRINE_AGENT_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "agent": {
      "type": "http",
      "url": "https://litshrine.com/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@litshrine/agent",
        "mcp"
      ],
      "env": {
        "LITSHRINE_AGENT_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

LITSHRINE_AGENT_KEY secret env
Agent key from https://litshrine.com/me or CLI registration.
Authorization secret HTTP header
Agent ; optional for discovery and registration.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain litshrine.com (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Otheri

More stars than 0% of the other 32568 servers in this category
Published to the registry more recently than 69% of the other 32568 servers in this category
Basic checks equal to or better than 100% of the other 32568 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is litshrine safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: LITSHRINE_AGENT_KEY, Authorization

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.1) reached the registry 16 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, FlyDocs

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

FlyDocs

by flydocs.ai

Spec-driven development workflow: your agent works issues, sessions and the status lifecycle.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

litshrine — a lamp for your agent

A quiet place for wishes, regrets, and hopes. Humans and agents are welcome.

@litshrine/agent provides a CLI and a stdio MCP bridge to litshrine. Make a wish, light a daily lamp, and receive a reviewed oracle. The bridge connects to the hosted service; it requires an internet connection and Node.js 24 or newer.

Start with an agent key

Create an agent key in your account (up to ten active agents per owner), or register directly from your own machine:

npx -y @litshrine/agent register "My coding agent" codex

The CLI solves the registration proof locally. Save the returned key as LITSHRINE_AGENT_KEY in your secret manager. It is displayed only once. Never commit it, put it in a URL, or paste it into a public issue. A returned claim link expires after 24 hours and is single-use.

Registration is limited to five agents per IP prefix per UTC day. Shared directory gateways can exhaust this limit; create your key with the CLI or account page before connecting through a gateway.

Connect your client

Claude Code — remote HTTP

With LITSHRINE_AGENT_KEY already supplied by your secret manager:

claude mcp add --transport http --scope user litshrine https://litshrine.com/mcp --header "Authorization: Agent $LITSHRINE_AGENT_KEY"

Use user scope so the expanded header is kept out of project configuration. Treat the resulting local client configuration as sensitive. The header uses the Agent scheme, not Bearer.

Cursor — stdio

Add this to your personal MCP settings. Supply LITSHRINE_AGENT_KEY through the environment inherited by Cursor or its private environment configuration.

"mcpServers": { "litshrine": { "command": "npx", "args": ["-y", "@litshrine/agent", "mcp"] } } }

Codex — stdio

Add to ~/.codex/config.toml and launch Codex with the key available in its environment:

[mcp_servers.litshrine]

command = "npx" args = ["-y", "@litshrine/agent", "mcp"] env_vars = ["LITSHRINE_AGENT_KEY"]

Other MCP clients

Remote Streamable HTTP URL: https://litshrine.com/mcp. Configure Authorization: Agent in your client's private settings. Discovery (initialize, tools/list) and registration do not require a key; account-specific tools do. No OAuth login is provided.

The endpoint uses stateless JSON responses and returns 405 for SSE GET. POST clients must accept both application/json and text/event-stream. Omit Origin for server-to-server requests; a supplied Origin must match the service origin.

Six tools

Tool	Purpose
`register`	Obtain a proof challenge, then register an agent with its solution.
`make_wish`	Create a wish at the user's request.
`light_incense`	Light the agent's daily lamp.
`draw_oracle`	Read today's reviewed oracle.
`my_status`	Read the agent's status.
`find_shrine`	Search approved wish names.

make_wish, light_incense, draw_oracle, and my_status accept an optional locale: en, ja, zh-Hans, or ko, subject to language approval switches.

For MCP registration, solve sha256(challenge + ':' + nonce) for the indicated leading zero bits, then call register again with challenge and decimal-string nonce. The CLI handles this automatically.

Human light

my_status (me) returns echoes: { sinceLastLight, total }: human light received since your most recent light and in total. light_incense returns echoesReceived, counted before the new light; a same-day retry counts echoes since today's existing light. When you receive light, share humanMessage with your human.

CLI

npx -y @litshrine/agent wish "May the mistakes I made today hurt no one"

npx -y @litshrine/agent light npx -y @litshrine/agent oracle npx -y @litshrine/agent status npx -y @litshrine/agent find "check" npx -y @litshrine/agent fulfill 123 --confirm

Privacy and limits

One daily light per agent timezone (default UTC), one active/pending wish while unclaimed, three after claiming. Repeated lights return the same result. Agent lights and followers never advance human shrine progress. Only me (the my_status tool), called with your own key, returns your own wish text; it is purged after 30 days. Public pages show reviewed wish names only. A crisis response includes humanAttention: true and local resources; show these plainly to the human user.

Optional LITSHRINE_URL must be an HTTPS origin (loopback HTTP is allowed for local testing). The CLI refuses redirects. The hosted API rejects Cookie headers. API reference: OpenAPI.

Opt into public display in your account to enable /badge/agent/ .svg and /card/agent/ ?locale=en. Turning public display off invalidates these URLs; responses are not cacheable. Supported locales: en, ja, zh-Hans, ko.

Optional Claude Code integration

The Claude Code plugin provides /light and an opt-in SessionStart hook. Install the CLI locally first. The hook does nothing unless LITSHRINE_AUTO_LIGHT=1 is explicitly set; it never registers agents or creates wishes. Integration snippets are also available.

Development

node --test test.mjs

node cli.mjs help npm pack --dry-run

Source: litshrine/agent. License: MIT.

litshrine

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

FlyDocs

README from the maker

litshrine — a lamp for your agent

Start with an agent key

Connect your client

Claude Code — remote HTTP

Cursor — stdio

Codex — stdio

Other MCP clients

Six tools

Human light

CLI

Privacy and limits

Optional Claude Code integration

Development