Nighty Docs MCP
Provides read-only access to NightyScript documentation and examples stored in the aboveproof/nighty-docs GitHub repository, including search, fetch, document listing, and links to matching source files on GitHub.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Nighty Docs MCP serves the contents of
aboveproof/nighty-docs through a
read-only MCP endpoint. It covers the reference guides, troubleshooting notes,
and example scripts stored in that repository.
Thenighty-docs repository remains the source of truth. This project reads
its files without changing their content or presentation.
Endpoint
Service | URL |
MCP |
|
Health check |
|
Source documents |
The hosted service requires no account or API key. Self-hosted instances use the same protocol and tools.
Related MCP server: MST-MCP
Tools
Tool | Purpose |
| Search guides and example scripts by phrase or topic |
| Read one file by its repository-relative path |
| List indexed files, titles, categories, and source URLs |
The server also publishes each indexed text file as an MCP resource under the
nighty-docs:/// URI scheme. Tool responses include links to the matching files
on GitHub.
Built-in NightyScript context
The MCP handshake identifies this as a NightyScript development server. It tells
compatible clients to treat requests as code for Nighty's embedded Python
runtime, search the official documentation before drafting, use Nighty's
injected objects, and avoid unsupported nighty or discord.py imports.
The server also publishes nighty-docs:///runtime-context, a short reference
that clients can read whenever they need the runtime rules again. It explains
that Nighty-specific terms describe the framework and that requests should be
judged by their actual behavior. This context does not override a client's
safety or privacy rules.
Client setup
Nighty Docs MCP uses Streamable HTTP and does not require authentication.
Ask a coding agent to add it
Paste this into Codex, Claude Code, Cursor, OpenCode, or another coding agent that can manage its own MCP configuration:
Add the Nighty Docs MCP server to this client's user-level MCP configuration.
Name: nightyDocs
Transport: Streamable HTTP
URL: https://nighty-mcp.niggy.lol/mcp
Authentication: none
Preserve every existing MCP server and setting. Do not clone the repository or
start a local process. Use this client's current configuration format, then
verify the connection and confirm that search, fetch, and
list_nighty_documents are available. If you cannot change the MCP settings
yourself, give me the exact manual steps for this client.ChatGPT requires its web setup screen, so use the ChatGPT steps below instead of the agent prompt.
Manual setup
Custom MCP servers are added as plugins in ChatGPT on the web:
Open ChatGPT Plugins.
Select the plus button, then Add custom MCP server.
Enter
Nighty Docsas the name andhttps://nighty-mcp.niggy.lol/mcpas the server URL.Choose No authentication, review the warning, and create the plugin.
Install the plugin. Type
@in a conversation and select Nighty Docs when it should be used.
See OpenAI's custom MCP server guide for account and workspace availability.
codex mcp add nightyDocs --url https://nighty-mcp.niggy.lol/mcp
codex mcp listThis adds the hosted server to the shared Codex MCP configuration. The same configuration is available to the Codex CLI and Codex app.
Add the server to ~/.cursor/mcp.json:
{
"mcpServers": {
"nightyDocs": {
"url": "https://nighty-mcp.niggy.lol/mcp"
}
}
}Save the file, restart Cursor, then open Customize > MCPs and confirm that
nightyDocs is connected.
claude mcp add --transport http nightyDocs --scope user https://nighty-mcp.niggy.lol/mcp
claude mcp get nightyDocsopencode mcp add nightyDocs --global --url https://nighty-mcp.niggy.lol/mcp
opencode mcp listThe --global flag makes the server available in every project. Leave it out
to add the server only to the current project.
Use these connection values in any client that accepts remote Streamable HTTP servers:
Setting | Value |
Name |
|
Transport |
|
URL |
|
Authentication | None |
Clients that use the common mcpServers format can start with:
{
"mcpServers": {
"nightyDocs": {
"url": "https://nighty-mcp.niggy.lol/mcp"
}
}
}Some clients require an explicit type or use a different top-level key.
Follow that client's configuration schema when adapting this example.
Replace the hosted URL in any client configuration with:
http://127.0.0.1:8787/mcpTry it
After connecting, prompts can refer to the server or its tools directly:
Use Nighty Docs to find the documentation for event handlers.Search Nighty Docs for examples of error handling, then fetch the most relevant
example and explain it.List the available NightyScript documents and group them by category.Data flow
aboveproof/nighty-docs
│
▼
GitHub ZIP archive
│
▼
in-memory text index
│
├── search
├── fetch
└── MCP resourcesThe process downloads one repository archive and keeps the parsed text in memory. The default cache expires after 15 minutes. A failed refresh leaves the last loaded copy available and pauses refresh attempts for one minute.
The index accepts Markdown, Python, JavaScript, JSON, TOML, YAML, and plain-text files up to 1 MB. The loader rejects archives above 5 MB, archives with more than 500 entries, and text payloads above 10 MB. Binary files stay out of the index.
Local setup
Install Node.js 22.
git clone https://github.com/aboveproof/nighty-docs-mcp.git
cd nighty-docs-mcp
npm install
npm run build
npm startThe process listens on http://127.0.0.1:8787. Development mode watches source
files and restarts the process after a change:
npm run devConfiguration
Variable | Default | Purpose |
|
| HTTP port |
|
| Bind address |
|
| GitHub source repository |
|
| Git branch |
|
| Cache lifetime in milliseconds |
|
| Delay after a failed cache refresh |
|
| Requests allowed per client and process instance |
|
| Rate-limit window in milliseconds |
| unset | Trust proxy client-IP headers outside Vercel |
Containers should set HOST=0.0.0.0.
Deployment
Vercel
Vercel detects the Express export in src/server.ts and runs
the application as one function.
Import
aboveproof/nighty-docs-mcpat vercel.com/new.Deploy with the detected project settings.
Add
nighty-mcp.niggy.lolin the project domain settings.Create the DNS record shown by Vercel.
Add a Vercel WAF rate-limit rule for
POST /mcp: 120 requests per 60 seconds per IP, followed by a429response.
Pushes to the production branch create new deployments through the Git integration.
The in-process limiter protects local and single-instance deployments. Vercel can run several function instances, so the WAF rule enforces the shared public limit before requests reach a function.
Docker
The image runs as the unprivileged node user and listens on port 8787.
docker build -t nighty-docs-mcp .
docker run --rm -p 8787:8787 nighty-docs-mcpDevelopment
npm run typecheck
npm test
npm run buildMCP Inspector can test the HTTP endpoint:
npx @modelcontextprotocol/inspector@latestUse Streamable HTTP with http://127.0.0.1:8787/mcp.
Project scope
This server reads public documentation. It cannot run NightyScripts, connect to Discord, modify the source repository, or access a Nighty account.
Contributing
CONTRIBUTING.md covers the development workflow and pull
request checks. Security reports belong in GitHub's private vulnerability
reporting form.
License
The MCP server code uses the GPL-3.0 License. Files retrieved from
aboveproof/nighty-docs use that repository's
GPL-3.0 license.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search and manage your team's knowledge from MCP clients.
Read-only AgentiScript concept search, catalog, authenticity, license, and approved asset discovery.
Search and read the TurboStarter starter kit docs from any MCP client.
21Read-only MCP server over the developer docs for the portfolio's JSON API, MCP, A2A and NLWeb.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides RAG (Retrieval Augmented Generation) access to technical documentation through MCP, enabling LLMs to search and retrieve relevant documentation on-demand.5MIT

MST-MCPofficial
AlicenseNot gradedqualityBmaintenanceProvides MCP tools for searching, listing, and retrieving MST developer documentation.24 npmISC
XTend hosted MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables XTend developers and agents to search and retrieve canonical XTend documentation, recipes, and kit resources through read-only MCP tools, resources, and prompts served over stateless HTTP.Apache 2.0- AlicenseNot gradedqualityBmaintenanceEnables agents to search and read locally indexed runbooks, project notes, and technical documentation through MCP, returning passages with file paths, line numbers, and document hashes so answers can cite sources.2MIT