Registry / llm-agents / graphlit-mcp-server

graphlit-mcp-server

library1.0.20260112001jsnpmunverified

Graphlit MCP Server (v1.0.20260112001) is a Model Context Protocol server that integrates with the Graphlit platform to provide tools for ingestion, retrieval, RAG, web crawling, and data connectors (Slack, Discord, Google Drive, Jira, GitHub, etc.). It enables MCP clients like Cursor, Windsurf, Goose, or Cline to access a searchable, RAG-ready knowledge base. The server extracts documents (PDF, DOCX, PPTX) to Markdown and transcribes audio/video. It is actively maintained with frequent releases, and offers built-in web search and crawling, eliminating the need for separate tools like Firecrawl. Requires Node >=18.

llm-agents web-framework

npm install graphlit-mcp-server

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GRAPHLIT-MCP-SERVE

graphlit-mcp-server

llm-agentsjavascriptv1.0.20260112001

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

server

✓ import { server } from 'graphlit-mcp-server'

✗ const server = require('graphlit-mcp-server')

ESM-only as of v1. Requires Node >=18

GraphlitMcpServer

✓ import { GraphlitMcpServer } from 'graphlit-mcp-server'

Named export for the server class

defineTool

✓ import { defineTool } from 'graphlit-mcp-server/tools'

✗ import { defineTool } from 'graphlit-mcp-server'

Tool definitions are exported from a subpath 'graphlit-mcp-server/tools'

createMcpServer

✓ import { createMcpServer } from 'graphlit-mcp-server'

✗ import createMcpServer from 'graphlit-mcp-server'

This is a named export, not default

Initializes and starts the Graphlit MCP server using environment variables for authentication. Requires GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET to be set.

import { createMcpServer } from 'graphlit-mcp-server'; const server = createMcpServer({ environmentId: process.env.GRAPHLIT_ENVIRONMENT_ID ?? '', organizationId: process.env.GRAPHLIT_ORGANIZATION_ID ?? '', jwtSecret: process.env.GRAPHLIT_JWT_SECRET ?? '' }); // Start the server (uses stdio transport by default) server.listen(); console.log('Graphlit MCP Server running...');

graphlit-mcp-server --version

Debug

Known issues

gotchaEnvironment variables must be set before starting the server; missing any will cause a startup error with a message like 'Missing required environment variable'.

fix

Set GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET in your environment or .env file.

affects: >=1.0.0

deprecatedThe old 'server' export has been deprecated in v1.0.20260112001; use 'createMcpServer' instead.

fix

Replace 'server' with 'createMcpServer' in your imports and usage.

affects: >=1.0.20260112001

gotchaThe server uses stdio transport by default; if your MCP client expects a different transport (e.g., HTTP), you must configure it explicitly.

fix

Pass transport option to createMcpServer or server.listen() as per documentation.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'graphlit-mcp-server'

Package not installed or wrong import path in CommonJS project.

fix

Run 'npm install graphlit-mcp-server' and ensure you use ESM (import) syntax, or use dynamic import if required.

Missing required environment variable: GRAPHLIT_ENVIRONMENT_ID

Environment variables not set before starting the server.

fix

Set GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET in your environment.

TypeError: createMcpServer is not a function

Importing from wrong path or using default import instead of named import.

fix

Use import { createMcpServer } from 'graphlit-mcp-server' (named import).

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported

Using CommonJS require() on an ESM-only package.

fix

Switch to ESM (import) or use dynamic import: const mod = await import('graphlit-mcp-server').

Upgrade

Version history

1.0.20260112001latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/graphlit/graphlit-mcp-server ↗

packagehttps://www.npmjs.com/package/graphlit-mcp-server ↗

homepagehttps://graphlit.com ↗