Apidog tests MCP

Adds possibility to work with testing management via MCP

MCP (Model Context Protocol) server for managing Apidog test cases, scenarios, suites, and test data. Gives AI assistants full read/write access to Apidog's test management features.

This project is not an official Apidog integration.

- Test Cases-- Create, read, update, delete, and bulk-create test cases for API endpoints
- Test Scenarios-- Build multi-step test flows chaining multiple API calls
- Test Suites-- Organize tests into runnable suites for CI/CD
- Test Data-- Manage data-driven test iterations with CSV-formatted data
- Folders-- Organize scenarios and suites into nested folder structures
- Read-only tools-- List environments, endpoints, categories, tags, runners, and coverage statistics

- docs/PRACTICAL-USAGE.md-- proven patterns for creating stable test cases/scenarios/suites
- SECURITY.md-- vulnerability reporting and secure usage guidelines
- CONTRIBUTING.md-- contribution workflow
- CHANGELOG.md-- release notes

npm install -g @acabala/apidog-tests-mcp

The server requires these environment variables:

Add to your MCP client config (e.g. Claude Desktopclaude_desktop_config.json):

{ "mcpServers": { "apidog-tests": { "command": "npx", "args": ["@acabala/apidog-tests-mcp"], "env": { "APIDOG_ACCESS_TOKEN": "your-token", "APIDOG_PROJECT_ID": "your-project-id", "APIDOG_BRANCH_ID": "your-branch-id" } } } }

- Use a dedicated token for automation.
- Scope access to the minimum required Apidog project(s).
- Rotate tokens regularly.
- Keep MCP client config files local/private.

# Install dependencies npm install # Run in development mode npm run start:dev # Type check npm run typecheck # Format npm run format # Run tests npm test # Run tests with coverage npm run test:coverage # Build for production npm run build

- Use a dedicated automation token with minimal required permissions.
- Never commitAPIDOG_ACCESS_TOKENor environment-specific IDs.
- Keep local MCP client config files private.
- SeeSECURITY.mdfor reporting and response policy.

This repository uses Changesets and a GitHub Actions release workflow:

- Add a changeset for user-visible changes:npm run changeset
- Release automation creates/updates a version PR onmain
- Merged release PR publishes to npm with provenance

- Contribution guide:CONTRIBUTING.md
- Code of conduct:CODE_OF_CONDUCT.md
- Changelog:CHANGELOG.md

- Always includepathandparameters.pathwhen creating route-parameterized test cases.
- For update operations, prefer this server's merge-style tools over raw full-replace payloads.
- UsecustomScriptpost-processors for assertions to avoid runner issues with declarative assertions.
- Seedocs/PRACTICAL-USAGE.mdfor complete examples.

src/ index.ts Entry point, registers tools and starts MCP server client.ts ApidogClient HTTP wrapper with auth headers types.ts Shared TypeScript interfaces and MCP result helpers errors.ts Custom error classes (ApidogApiError, ApidogConfigError) schemas.ts Shared Zod schemas for request parameters tools/ read.ts Read-only tools (environments, endpoints, categories, etc.) test-cases.ts Test case CRUD tools test-scenarios.ts Test scenario CRUD tools test-suites.ts Test suite CRUD tools test-data.ts Test data CRUD tools folders.ts Folder management tools

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server for interacting with the Postman API, requiring an API key.

An enhanced Apifox MCP service providing comprehensive API management capabilities for Claude Desktop and Cursor.

This MCP Server accepts swagger/postman documents as input. It then generates API & Load test scenarios, executes the tests and generates the execution report.

A Model Context Protocol (MCP) server for creating, managing, and executing Bruno API testing collections. Supports both .bru and .yml (opencollection) formats with built-in security hardening.

Execute Bruno collections using the Bruno CLI, with support for environment files and detailed test results.

An MCP server exposing Hoverfly as a programmable API simulation tool for AI assistants.

A free public REST API for testing and prototyping, powered by JSONPlaceholder.

Postman for MCP — search 156 servers, inspect tools with schema visualizer, test live

An AI-native API testing platform for generating scenarios, executing tests, and analyzing results.

An MCP server and client implementation for the Swagger Petstore API.