Skip to main content
Glama
sharedlore-ai

Lore MCP

Official
by sharedlore-ai
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@sharedlore/mcp

A thin MCP server over the lore-api GraphQL endpoint. It gives an AI agent team-shared "lore": area context docs, append-only session captures, and structured docs (ADRs, logs, TODOs, plans).

The server is stateless — every tool call hits the lore-api GraphQL endpoint over HTTPS.

Tools

Tool

What it does

lore_start

Team /start: loads the project briefing (area context docs + recent captures). Optional directive.

lore_capture

Append a session capture to a node (by path or id). Append-only; triggers server-side context synthesis.

lore_adr

Create/update an ADR node by path (kind adr).

lore_log

Create/update a log node by path (kind log).

lore_todo

Create/update a TODO node by path (kind todo).

lore_plan

Create/update a plan node by path (kind plan).

lore_tree

List the folder/doc tree (optionally scoped by parentId or kind).

lore_context

Fetch the derived area context document at a path.

lore_search

Search nodes by path substring (optional kind).

Every write/read tool accepts an optional project slug; if omitted it falls back to LORE_PROJECT.

Related MCP server: kb

Configuration (env)

Var

Default

Purpose

LORE_API_URL

http://localhost:3030/graphql

GraphQL endpoint.

LORE_API_TOKEN

—

The lore_sk_... API token. Sent as Authorization: Bearer <token>. The token scopes the org server-side, so no org header is needed.

LORE_PROJECT

—

Default project slug used when a tool omits project.

Getting a token

In the SharedLore dashboard, go to API tokens and create a new token. Copy the lore_sk_... value (shown once) into LORE_API_TOKEN. A token's role (admin / member / viewer) determines what it can do — a viewer token cannot capture or upsert and tools will return a clear "not authorized" message.

Connect (.mcp.json)

{
  "mcpServers": {
    "sharedlore": {
      "command": "npx",
      "args": ["-y", "@sharedlore/mcp"],
      "env": {
        "LORE_API_URL": "https://lore.example.com/graphql",
        "LORE_API_TOKEN": "lore_sk_xxx",
        "LORE_PROJECT": "my-project-slug"
      }
    }
  }
}

Develop

npm install
npm run build   # tsc -> dist/
npm run dev     # tsc --watch

Requires Node 20+ (uses the global fetch).

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sharedlore-ai/lore-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server