Mcp Api Reference — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Mcp Api Reference (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.
An MCP (Model Context Protocol) server that automatically crawls, indexes, and serves API reference documentation for LLMs.
When LLMs generate code that uses APIs, the following problems occur:
This tool automatically crawls, parses, and indexes API reference sites just by specifying a URL, then provides token-efficient search results via MCP tools.
| Tool | Description | Main Inputs |
|---|---|---|
search_docs | Full-text search by keyword | query, api (optional), limit (1-20) |
get_endpoint | Get details of a specific endpoint | api, endpoint (path), method |
list_apis | List available APIs and categories | api (optional) |
npm install
npm run buildnode dist/index.js# Specify a custom config file
node dist/index.js --config ./my-sites.json
# Refresh cache for a specific API
node dist/index.js --refresh kintone
# Clear all cache
node dist/index.js --clear-cache| Option | Short | Description |
|---|---|---|
--config <path> | -c | Path to custom site config file |
--refresh <api-id> | -r | Re-fetch documentation for the specified API |
--clear-cache | - | Clear all cache and exit |
Add the following to claude_desktop_config.json:
{
"mcpServers": {
"api-reference": {
"command": "node",
"args": ["/path/to/mcp-reference-doc/dist/index.js"]
}
}
}A parser for the kintone REST API is built in as a preset. No additional configuration required.
A parser for the Backlog API is also available as a preset. No additional configuration required.
A parser for the SmartHR API is also available as a preset. No additional configuration required.
You can add any API documentation site by specifying a JSON file with the --config option.
{
"sites": [
{
"id": "my-api",
"name": "My API",
"baseUrl": "https://api.example.com",
"crawl": {
"startUrl": "https://api.example.com/docs",
"includePatterns": ["https://api.example.com/docs/**"],
"excludePatterns": [],
"maxPages": 500,
"delayMs": 500
},
"parser": {
"type": "generic",
"selectors": {
"endpointContainer": ".endpoint",
"method": ".http-method",
"path": ".api-path",
"title": "h3",
"description": ".description",
"parameters": ".parameters",
"responseFields": ".response"
}
}
}
]
}src/
├── index.ts # CLI entry point
├── server.ts # MCP server initialization and tool registration
├── core/
│ ├── crawler.ts # Web crawler with robots.txt support
│ ├── parser.ts # Parser registry
│ ├── generic-parser.ts # Generic HTML parser (CSS selector-based)
│ ├── indexer.ts # Full-text search index via MiniSearch
│ ├── store.ts # Document store
│ ├── cache.ts # TTL-based cache management
│ └── pipeline.ts # Crawl → parse → index pipeline
├── tools/
│ ├── search-docs.ts # search_docs tool
│ ├── get-endpoint.ts # get_endpoint tool
│ └── list-apis.ts # list_apis tool
├── presets/
│ ├── kintone/ # kintone preset
│ ├── backlog/ # Backlog preset
│ └── smarthr/ # SmartHR preset
├── formatters/
│ └── response.ts # MCP response formatter
├── types/ # Type definitions
└── utils/ # Utilities (logger, glob, hash)# Build in watch mode
npm run dev
# Run tests
npm test
# Run tests (watch mode)
npm run test:watch
# Type check
npm run typecheck
# Lint
npm run lint| Variable | Description | Default |
|---|---|---|
MCP_API_REF_CACHE_DIR | Path to cache directory | ~/.mcp-api-reference/cache/ |
MCP_API_REF_CONFIG | Path to site config file | - |
MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.