Lynxprompt MCP logo

Lynxprompt MCP

by GeiserX

Manage LynxPrompt blueprints and hierarchies through MCP, with marketplace search, read-only mode, stdio, and Streamable HTTP.

Install Lynxprompt MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "geiserx-lynxprompt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lynxprompt-mcp"
      ],
      "env": {
        "LYNXPROMPT_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

GeiserX/lynxprompt-mcp connects MCP clients to a hosted or self-hosted LynxPrompt instance for browsing, searching, and managing configuration blueprints and hierarchies. Its tools cover marketplace search, listing and reading accessible content, creation, updates, and deletion, while read-only resources expose the same data through LynxPrompt URIs. Run it through npm, Docker, or a Go binary over stdio or stateless Streamable HTTP. Reach for it when an agent needs access to shared prompt configurations, AGENTS.md or CLAUDE.md-oriented blueprints, or repository-based hierarchy organization.

Use cases

  • Search the public LynxPrompt marketplace for reusable blueprints
  • Read shared blueprints and repository hierarchies from an AI client
  • Create and update prompt configuration blueprints
  • Organize blueprints by repository root
  • Run a read-only LynxPrompt connection for agents

Key features

  • Searches the public blueprint marketplace
  • Creates, updates, and deletes blueprints
  • Creates and manages repository-based hierarchies
  • Exposes read-only MCP resources
  • Supports checksum-protected blueprint updates
  • Runs over stdio or Streamable HTTP

Tools6

What Lynxprompt MCP lets your agent do. Expand a tool for its parameters.

Verified live~567 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 85d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · lynxprompt-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads1.2kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Lynxprompt MCP works

What GeiserX/lynxprompt-mcp does

GeiserX/lynxprompt-mcp gives MCP-compatible AI clients access to a LynxPrompt instance. It can search the public blueprint marketplace, list a user's blueprints and hierarchies, read blueprints the authenticated user can access, and organize blueprints into repository-based hierarchies. Write operations cover creating, updating, and permanently deleting blueprints, plus creating and deleting hierarchies.

The server works with the hosted LynxPrompt service at lynxprompt.geiser.cloud or with a self-hosted deployment. Blueprints can represent AI configuration files such as AGENTS.md and CLAUDE.md; publishing a blueprint is controlled through its visibility when it is created.

How it works

Authentication uses an API token created in the LynxPrompt instance's Settings area. The server communicates with LynxPrompt on behalf of the MCP client and exposes both tools and read-only MCP resources. Available resource URI patterns include:

  • lynxprompt://blueprints
  • lynxprompt://blueprint/{id}
  • lynxprompt://hierarchies
  • lynxprompt://hierarchy/{id}
  • lynxprompt://user

Blueprint updates support optimistic concurrency: get_blueprint returns a content_checksum, which can be supplied as expected_checksum to prevent an update from silently replacing a change made elsewhere. Hierarchies group blueprints by repository root; creating one for an existing repository_root returns the existing hierarchy.

The process supports stdio and stateless Streamable HTTP at /mcp. HTTP deployments include Origin checks, a request body limit, and bearer authentication when exposed. The binary supports MCP revisions from 2024-11-05 through 2026-07-28.

Setup and configuration

Install the npm package with an MCP client's command configuration, or run the published Docker image in stdio mode. The npm launcher downloads the release binary on first use and verifies its SHA-256 checksum against checksums included in the package. Docker Compose, local builds, and HTTP deployment are also supported.

The required environment variable is:

  • LYNXPROMPT_TOKEN: API token for the LynxPrompt instance.

For a self-hosted instance, set LYNXPROMPT_URL to the server URL. Set LYNXPROMPT_READ_ONLY=true to register only read tools and hide write operations. The repository includes configurations for Claude Code, Claude Desktop, Cursor, VS Code, and Codex, as well as a Docker stdio example.

Tools and capabilities

Read operations include search_blueprints, list_blueprints, get_blueprint, list_hierarchies, and get_hierarchy. Marketplace search accepts filters such as query, configuration or command type, category, tags, sort order, and page.

Write operations include create_blueprint, update_blueprint, delete_blueprint, create_hierarchy, and delete_hierarchy. Blueprint deletion and hierarchy deletion are destructive; deleting a hierarchy keeps its blueprints but removes their association. Each tool provides metadata describing its title, read-only or destructive behavior, and output schema.

Limitations and notes

A token is required for access. Read-only mode removes write tools rather than merely blocking their use after registration. Updates should use the checksum returned by get_blueprint when preserving concurrent edits matters. Deleting a blueprint is permanent, while deleting a hierarchy leaves its blueprints intact but unlinked.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Lynxprompt MCP

GeiserX/lynxprompt-mcp is an MCP server that connects AI clients to hosted or self-hosted LynxPrompt instances. Its main tools search, list, and read blueprints and hierarchies, then create, update, or delete them. It also exposes read-only LynxPrompt resources and supports stdio or Streamable HTTP transport.

Install it through the npm command `npx -y lynxprompt-mcp`, or run the published Docker image in stdio mode. Configure `LYNXPROMPT_TOKEN` with an API token from LynxPrompt. Docker Compose, local builds, and HTTP deployment are also supported.

Yes, GeiserX/lynxprompt-mcp works with Cursor through Cursor's MCP configuration. Add an entry that runs `npx -y lynxprompt-mcp` and provide `LYNXPROMPT_TOKEN` in the environment. The repository also includes examples for Claude Code, Claude Desktop, VS Code, and Codex.

Set `LYNXPROMPT_URL` to the self-hosted LynxPrompt server URL and provide `LYNXPROMPT_TOKEN` with an API token created in that instance's Settings area. The server can then run through stdio or Streamable HTTP.

Set `LYNXPROMPT_READ_ONLY=true` to register only the read tools. This hides blueprint and hierarchy creation, update, and deletion operations while leaving marketplace search and read access available.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLynxprompt MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/geiserx-lynxprompt-mcp?style=directory)](https://allmcps.com/mcp/geiserx-lynxprompt-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/geiserx-lynxprompt-mcp"><img src="https://allmcps.com/api/badge/geiserx-lynxprompt-mcp?style=directory" alt="Lynxprompt MCP on AllMCPs" /></a>