Adonis Docs Mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Adonis Docs Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
MCP server that gives AI agents fast access to AdonisJS documentation (v5, v6, v7) and Edge.js template engine documentation.
Fetches raw markdown directly from the official GitHub repos and caches locally for speed.
# Run with uvx (no install needed)
uvx adonis-docs-mcpAdd to your MCP settings:
{
"mcpServers": {
"adonis-docs": {
"command": "uvx",
"args": ["adonis-docs-mcp"]
}
}
}Add to .vscode/mcp.json:
{
"servers": {
"adonis-docs": {
"command": "uvx",
"args": ["adonis-docs-mcp"]
}
}
}Add to your MCP config:
{
"mcpServers": {
"adonis-docs": {
"command": "uvx",
"args": ["adonis-docs-mcp"]
}
}
}Instead of copying these instructions manually, we strongly recommend using Agentfish to automatically install the exact rules, guidelines, and context required for an AdonisJS v7 project directly into your codebase.
uvx agentfish add pimentelleo/adonisjs7-agentThis will automatically create the necessary .cursorrules, CLAUDE.md, or .github/copilot-instructions.md files configured to use this MCP server.
| Tool | Description |
|---|---|
list_versions | List all available AdonisJS doc versions (v5, v6, v7) |
list_sections | Browse the documentation structure for a version |
get_doc | Fetch the full markdown content of a specific page |
search_docs | Search docs by keyword across titles and content |
clear_cache | Clear the local documentation cache |
| Tool | Description |
|---|---|
edge_list_sections | Browse the Edge.js documentation structure |
edge_get_doc | Fetch the full markdown content of an Edge.js doc page |
edge_search_docs | Search Edge.js docs by keyword |
| Tool | Description |
|---|---|
lucid_list_sections | Browse the Lucid ORM documentation structure |
lucid_get_doc | Fetch the full markdown content of a Lucid ORM doc page |
lucid_search_docs | Search Lucid ORM docs by keyword |
| Tool | Description |
|---|---|
packages_list | List all AdonisJS packages, optionally filtered by category |
packages_search | Search packages by keyword (name, description, category) |
packages_get | Get full details and README for a specific package |
# List what's available
list_versions()
# Browse v7 docs structure
list_sections(version="v7")
# Read the routing guide
get_doc(permalink="guides/basics/routing", version="v7")
# Search for authentication docs
search_docs(query="authentication", version="v7")
# Search across all versions
search_docs(query="middleware", version="all")
# Browse Edge.js template docs
edge_list_sections()
# Read Edge.js components docs
edge_get_doc(permalink="components/introduction")
# Search Edge.js docs
edge_search_docs(query="slots")
# Browse Lucid ORM docs
lucid_list_sections()
# Read Lucid relationships docs
lucid_get_doc(permalink="relationships")
# Search Lucid ORM docs
lucid_search_docs(query="migrations")
# List all packages
packages_list()
# List authentication packages
packages_list(category="Authentication")
# Search for a package
packages_search(query="jwt")
# Get full details and README for a package
packages_get(name="adonisjs-jwt")| Environment Variable | Default | Description |
|---|---|---|
ADONIS_DOCS_CACHE_TTL | 3600 | Cache TTL in seconds (default: 1 hour) |
ADONIS_DOCS_CACHE_DIR | ~/.cache/adonis-docs-mcp | Cache directory path |
| Version | GitHub Repo | Status |
|---|---|---|
| v7 | adonisjs/v7-docs | Latest (default) |
| v6 | adonisjs/v6-docs | Stable |
| v5 | adonisjs/v5-docs | Legacy |
| Edge.js | edge-js/edgejs.dev | Template engine |
| Lucid ORM | adonisjs/lucid.adonisjs.com | SQL ORM |
| Packages | adonisjs-community/adonis-packages | Community registry |
# Clone and install
git clone https://github.com/pimentelleo/adonis-docs-mcp.git
cd adonis-docs-mcp
uv sync
# Run locally
uv run adonis-docs-mcp
# Test with MCP Inspector
npx @modelcontextprotocol/inspector uv run adonis-docs-mcpThis project uses PyPI Trusted Publishing via GitHub Actions.
adonis-docs-mcppimentelleoadonis-docs-mcppublish.ymlpypiversion in pyproject.toml and src/adonis_docs_mcp/__init__.pyv0.1.0)MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.