Borrowing it
Nothing to install: this file belongs to sapientsai/dokploy-mcp-server. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/sapientsai/dokploy-mcp-server/main/CLAUDE.mdgit clone --depth 1 https://github.com/sapientsai/dokploy-mcp-serverWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/sapientsai/dokploy-mcp-server/claude-md)<a href="https://agentmods.dev/instructions/sapientsai/dokploy-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/sapientsai/dokploy-mcp-server/claude-md.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.02000 | $0.02000 |
| Opus 5 | $0.01000 | $0.01000 |
| Sonnet 5 | $0.00400 | $0.00400 |
| Haiku 4.5 | $0.00200 | $0.00200 |
Grade A, and why
dokploy-mcp-server CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
A comprehensive MCP (Model Context Protocol) server for Dokploy - the open-source, self-hosted PaaS. Provides 27 tools (one per category, using action enums) for managing deployments, applications, databases, domains, and servers through AI assistants.
Built with FastMCP, ts-builds, and Zod. Supports stdio (default for npx/CLI) and httpStream (for Docker/remote) transports.
Development Commands
pnpm validate # Main command: format + lint + test + build (use before commits)
pnpm format # Format code with Prettier
pnpm format:check # Check formatting only
pnpm lint # Fix ESLint issues
pnpm lint:check # Check ESLint issues only
pnpm test # Run tests once
pnpm test:watch # Run tests in watch mode
pnpm test:coverage # Run tests with coverage
pnpm build # Production build (outputs to dist/)
pnpm dev # Development build with watch mode
pnpm typecheck # Check TypeScript types
pnpm inspect # Build + open MCP Inspector to verify tools
Running a Single Test
pnpm test -- --testNamePattern="pattern" # Filter by test name
pnpm test -- test/specific.spec.ts # Run specific file
Architecture
Project Structure
src/
├── index.ts # FastMCP server setup, tool registration, transport config
├── bin.ts # CLI entry point (stdio default, --version, --help)
├── client/
│ ├── dokploy-client.ts # API client (singleton, x-api-key auth, GET/POST)
│ └── errors.ts # ApiError types, ValidationError, formatApiError
├── generated/ # Generated from openapi.json — do not hand-edit
│ ├── dokploy-api.ts # openapi-typescript output (pnpm openapi:generate)
│ ├── helpers.ts # RequestBody<T> / QueryParams<T> extractors
│ └── index.ts # Re-exports the generated types
├── tools/
│ ├── index.ts # Re-exports all tool registration functions
│ ├── types.ts # ToolServer — narrowed SomaServerInstance
│ ├── tool-utils.ts # pickDefined, env merge/mask helpers, jsonSection
│ ├── project-tools.ts # 1 tool (6 actions) - CRUD + duplicate
│ ├── application-tools.ts # 1 tool (23 actions) - full app lifecycle + search
│ ├── compose-tools.ts # 1 tool (21 actions) - Docker Compose management + search
│ ├── deployment-tools.ts # 1 tool (5 actions) - list, queueList, killProcess, readLogs, remove
│ ├── docker-tools.ts # 1 tool (17 actions) - containers, container files, events, health, disk usage
│ ├── docker-volume-tools.ts # 1 tool (8 actions) - volumes + files inside them
│ ├── docker-image-tools.ts # 1 tool (3 actions) - image inventory
│ ├── network-tools.ts # 1 tool (8 actions) - Docker networks + host import
│ ├── overview-tools.ts # 1 tool (3 actions) - fleet-wide rollups (read-only)
│ ├── dns-provider-tools.ts # 1 tool (11 actions) - DNS providers + zone/record CRUD
│ ├── vault-provider-tools.ts # 1 tool (7 actions) - external secret managers; names never values
│ ├── domain-tools.ts # 1 tool (9 actions) - domain/DNS management
│ ├── redirects-tools.ts # 1 tool (4 actions) - URL redirect rules on applications
│ ├── server-tools.ts # 1 tool (8 actions) - remote server management
│ ├── settings-tools.ts # 1 tool (5 actions) - health, version, cleanup, reload
│ ├── database-tools.ts # 1 tool (17 actions) - unified DB management + search
│ ├── backup-tools.ts # 1 tool (6 actions) - DB backup scheduling/triggers
│ ├── volume-backup-tools.ts # 1 tool (6 actions) - volume-level backup schedules
│ ├── preview-deployment-tools.ts # 1 tool (4 actions) - PR/branch preview deploys
│ ├── schedule-tools.ts # 1 tool (6 actions) - cron on app/compose/server/dokploy
│ ├── audit-log-tools.ts # 1 tool (1 action) - audit log query with filters
│ ├── environment-tools.ts # 1 tool (6 actions) - project environments
│ ├── infrastructure-tools.ts # 1 tool (8 actions) - ports, certs, basic auth
│ ├── mounts-tools.ts # 1 tool (6 actions) - volume / bind / file mounts
│ ├── ssh-key-tools.ts # 1 tool (6 actions) - SSH key management
│ ├── registry-tools.ts # 1 tool (7 actions) - container registries
│ └── destination-tools.ts # 1 tool (6 actions) - S3-compatible backup destinations
├── types.ts # TypeScript types + DB type constants
└── utils/
└── formatters.ts # Markdown output formatters
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 7d ago First seen · 144 lines · 2,000 tokens per session scan A f794f69f8d17
dokploy-mcp-server CLAUDE.md is an instructions file published in the GitHub repository sapientsai/dokploy-mcp-server (2 stars, last pushed 4d ago), licensed MIT. It adds 2,000 tokens to every session, about $0.0100 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.