{"id":27852,"library":"graphlit-mcp-server","title":"Graphlit MCP Server","description":"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.","status":"active","version":"1.0.20260112001","language":"javascript","source_language":"en","source_url":"https://github.com/graphlit/graphlit-mcp-server","tags":["javascript","Graphlit","API","LLM","AI","RAG","OpenAI","PDF","parsing"],"install":[{"cmd":"npm install graphlit-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add graphlit-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add graphlit-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only as of v1. Requires Node >=18","wrong":"const server = require('graphlit-mcp-server')","symbol":"server","correct":"import { server } from 'graphlit-mcp-server'"},{"note":"Named export for the server class","wrong":"","symbol":"GraphlitMcpServer","correct":"import { GraphlitMcpServer } from 'graphlit-mcp-server'"},{"note":"Tool definitions are exported from a subpath 'graphlit-mcp-server/tools'","wrong":"import { defineTool } from 'graphlit-mcp-server'","symbol":"defineTool","correct":"import { defineTool } from 'graphlit-mcp-server/tools'"},{"note":"This is a named export, not default","wrong":"import createMcpServer from 'graphlit-mcp-server'","symbol":"createMcpServer","correct":"import { createMcpServer } from 'graphlit-mcp-server'"}],"quickstart":{"code":"import { createMcpServer } from 'graphlit-mcp-server';\n\nconst server = createMcpServer({\n  environmentId: process.env.GRAPHLIT_ENVIRONMENT_ID ?? '',\n  organizationId: process.env.GRAPHLIT_ORGANIZATION_ID ?? '',\n  jwtSecret: process.env.GRAPHLIT_JWT_SECRET ?? ''\n});\n\n// Start the server (uses stdio transport by default)\nserver.listen();\n\nconsole.log('Graphlit MCP Server running...');","lang":"typescript","description":"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."},"warnings":[{"fix":"Set GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET in your environment or .env file.","message":"Environment variables must be set before starting the server; missing any will cause a startup error with a message like 'Missing required environment variable'.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Replace 'server' with 'createMcpServer' in your imports and usage.","message":"The old 'server' export has been deprecated in v1.0.20260112001; use 'createMcpServer' instead.","severity":"deprecated","affected_versions":">=1.0.20260112001"},{"fix":"Pass transport option to createMcpServer or server.listen() as per documentation.","message":"The server uses stdio transport by default; if your MCP client expects a different transport (e.g., HTTP), you must configure it explicitly.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'npm install graphlit-mcp-server' and ensure you use ESM (import) syntax, or use dynamic import if required.","cause":"Package not installed or wrong import path in CommonJS project.","error":"Error: Cannot find module 'graphlit-mcp-server'"},{"fix":"Set GRAPHLIT_ENVIRONMENT_ID, GRAPHLIT_ORGANIZATION_ID, and GRAPHLIT_JWT_SECRET in your environment.","cause":"Environment variables not set before starting the server.","error":"Missing required environment variable: GRAPHLIT_ENVIRONMENT_ID"},{"fix":"Use import { createMcpServer } from 'graphlit-mcp-server' (named import).","cause":"Importing from wrong path or using default import instead of named import.","error":"TypeError: createMcpServer is not a function"},{"fix":"Switch to ESM (import) or use dynamic import: const mod = await import('graphlit-mcp-server').","cause":"Using CommonJS require() on an ESM-only package.","error":"Error [ERR_REQUIRE_ESM]: require() of ES Module not supported"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}