Graphlit MCP Server

1.0.20260112001 verified Sat May 09 auth: no javascript

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.

Common errors

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

cause 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.

error Missing required environment variable: GRAPHLIT_ENVIRONMENT_ID ↓

cause Environment variables not set before starting the server.

fix

Set GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET in your environment.

error TypeError: createMcpServer is not a function ↓

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

fix

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

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

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

fix

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

Warnings

gotcha Environment 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.

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

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

gotcha The 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.

Install

npm install graphlit-mcp-server

yarn add graphlit-mcp-server

pnpm add graphlit-mcp-server

Imports

server

wrong

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

correct

import { server } from '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

wrong

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

correct

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

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

createMcpServer

wrong

import createMcpServer from 'graphlit-mcp-server'

correct

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

This is a named export, not default

Quickstart

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...');