get_server_statusLABSCO SUMMARY
PureScript answers without the IDE tax.
Most structural questions about a PureScript project — what does this module export, who imports it — do not need a language server running. This answers those from the source and starts the IDE only when types are genuinely required.
What it is
A PureScript development server for AI assistants. Structural questions are answered by parsing the source directly, and a PureScript IDE server is started and managed only when a question needs type information.
What you get
- Code structure parsed straight from source — module name, imports, exports and function definitions — with no IDE running
- A PureScript IDE server started and managed for you when type answers are needed
- Type lookups and usage search across the project
- Module dependency graphs generated as a visual representation rather than a flat list
- A server status check, so a silent client is diagnosable
Requirements
Install globally with npm, or clone and run from source, then add one stdio entry to your client config. Type lookups need a PureScript IDE server, which the server can start itself.
Setup effort
One command — npm install -g purescript-mcp-tools
USE CASES
01
Getting oriented in an unfamiliar PureScript project
Module names, imports and exports read straight off the source, before anything has to be compiled.
02
Tracing what depends on what
A dependency graph of the modules, drawn rather than described, for when the import chain has stopped fitting in your head.
03
Answering a type question mid-edit
The IDE server starts on demand and the type comes back, so a quick question does not cost a full editor session.
04
Finding every use of a function before you change it
Usage search across the project, so a rename is scoped before it starts.
16 tools
Listed in project docs. Your client may show a different list.
getModuleNamegetImportsgetAllFunctionNamesgetExportsgetFunctionSignaturegetDependencyGraphstart_purs_ide_serverstop_purs_ide_serverpursIdeLoadpursIdeTypepursIdeCompletepursIdeUsagespursIdeCaseSplitpursIdeAddClausepursIdeImportBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js >= 14.0.0
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g purescript-mcp-toolsMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"purescript-tools": {
"command": "npx",
"args": [
"purescript-mcp-tools"
]
}
}
}Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"purescript-tools": {
"command": "node",
"args": [
"<YOUR_PATH_TO_PURESCRIPT_MCP_TOOLS>/index.js"
]
}
}
}
