{
  "markdown": "# apidog-tests-mcp\n\nMCP (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.\n\n> This project is not an official Apidog integration.\n\n## Features\n\n- **Test Cases** -- Create, read, update, delete, and bulk-create test cases for API endpoints\n- **Test Scenarios** -- Build multi-step test flows chaining multiple API calls\n- **Test Suites** -- Organize tests into runnable suites for CI/CD\n- **Test Data** -- Manage data-driven test iterations with CSV-formatted data\n- **Folders** -- Organize scenarios and suites into nested folder structures\n- **Read-only tools** -- List environments, endpoints, categories, tags, runners, and coverage statistics\n\n## Documentation\n\n- `docs/PRACTICAL-USAGE.md` -- proven patterns for creating stable test cases/scenarios/suites\n- `SECURITY.md` -- vulnerability reporting and secure usage guidelines\n- `CONTRIBUTING.md` -- contribution workflow\n- `CHANGELOG.md` -- release notes\n\n## Installation\n\n```bash\nnpm install -g @acabala/apidog-tests-mcp\n```\n\nOr use directly with npx:\n\n```bash\nnpx @acabala/apidog-tests-mcp\n```\n\n## Configuration\n\nThe server requires these environment variables:\n\n| Variable              | Required | Description                                                          |\n| --------------------- | -------- | -------------------------------------------------------------------- |\n| `APIDOG_ACCESS_TOKEN` | Yes      | Your Apidog access token                                             |\n| `APIDOG_PROJECT_ID`   | Yes      | The Apidog project ID                                                |\n| `APIDOG_BRANCH_ID`    | Yes      | The branch ID to work with                                           |\n| `APIDOG_BASE_URL`     | No       | Override the API base URL (default: `https://api.apidog.com/api/v1`) |\n\n### MCP Client Configuration\n\nAdd to your MCP client config (e.g. Claude Desktop `claude_desktop_config.json`):\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"apidog-tests\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"@acabala/apidog-tests-mcp\"],\n\t\t\t\"env\": {\n\t\t\t\t\"APIDOG_ACCESS_TOKEN\": \"your-token\",\n\t\t\t\t\"APIDOG_PROJECT_ID\": \"your-project-id\",\n\t\t\t\t\"APIDOG_BRANCH_ID\": \"your-branch-id\"\n\t\t\t}\n\t\t}\n\t}\n}\n```\n\n### Recommended Token Practices\n\n- Use a dedicated token for automation.\n- Scope access to the minimum required Apidog project(s).\n- Rotate tokens regularly.\n- Keep MCP client config files local/private.\n\n## Available Tools\n\n### Read-only\n\n| Tool                        | Description                                            |\n| --------------------------- | ------------------------------------------------------ |\n| `list_environments`         | List all environments with base URLs                   |\n| `list_api_endpoints`        | List API endpoint tree (filterable by module and name) |\n| `list_test_case_categories` | List test case categories                              |\n| `list_test_case_tags`       | List available tags                                    |\n| `list_runners`              | List self-hosted test runners                          |\n| `get_endpoint_statistics`   | Get test coverage statistics                           |\n\n### Test Cases\n\n| Tool                     | Description                                  |\n| ------------------------ | -------------------------------------------- |\n| `list_test_cases`        | List all test cases (filterable by endpoint) |\n| `get_test_case`          | Get full test case details                   |\n| `create_test_case`       | Create a test case for an endpoint           |\n| `create_test_cases_bulk` | Create multiple test cases at once           |\n| `update_test_case`       | Update a test case (GET-then-merge)          |\n| `delete_test_case`       | Delete a test case                           |\n\n### Test Scenarios\n\n| Tool                         | Description                          |\n| ---------------------------- | ------------------------------------ |\n| `list_test_scenarios`        | List scenarios with folder structure |\n| `get_test_scenario_steps`    | Get steps for a scenario             |\n| `create_test_scenario`       | Create a multi-step test scenario    |\n| `update_test_scenario_steps` | Set/replace scenario steps           |\n| `delete_test_scenario`       | Delete a scenario                    |\n\n### Test Suites\n\n| Tool                      | Description                             |\n| ------------------------- | --------------------------------------- |\n| `list_test_suites`        | List suites with folder structure       |\n| `get_test_suite`          | Get full suite details                  |\n| `create_test_suite`       | Create a test suite                     |\n| `update_test_suite_items` | Set suite items (static/dynamic groups) |\n| `delete_test_suite`       | Delete a suite                          |\n\n### Test Data\n\n| Tool               | Description                             |\n| ------------------ | --------------------------------------- |\n| `list_test_data`   | List test data records for a test case  |\n| `get_test_data`    | Get test data with CSV rows and columns |\n| `create_test_data` | Create test data for a test case        |\n| `update_test_data` | Update test data (GET-then-merge)       |\n| `delete_test_data` | Delete a test data record               |\n\n### Folders\n\n| Tool                     | Description              |\n| ------------------------ | ------------------------ |\n| `create_scenario_folder` | Create a scenario folder |\n| `delete_scenario_folder` | Delete a scenario folder |\n| `create_suite_folder`    | Create a suite folder    |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run start:dev\n\n# Type check\nnpm run typecheck\n\n# Format\nnpm run format\n\n# Run tests\nnpm test\n\n# Run tests with coverage\nnpm run test:coverage\n\n# Build for production\nnpm run build\n```\n\n## Security\n\n- Use a dedicated automation token with minimal required permissions.\n- Never commit `APIDOG_ACCESS_TOKEN` or environment-specific IDs.\n- Keep local MCP client config files private.\n- See `SECURITY.md` for reporting and response policy.\n\n## Release and Versioning\n\nThis repository uses Changesets and a GitHub Actions release workflow:\n\n- Add a changeset for user-visible changes: `npm run changeset`\n- Release automation creates/updates a version PR on `main`\n- Merged release PR publishes to npm with provenance\n\n## Open Source Guidelines\n\n- Contribution guide: `CONTRIBUTING.md`\n- Code of conduct: `CODE_OF_CONDUCT.md`\n- Changelog: `CHANGELOG.md`\n\n## Practical Tips\n\n- Always include `path` and `parameters.path` when creating route-parameterized test cases.\n- For update operations, prefer this server's merge-style tools over raw full-replace payloads.\n- Use `customScript` post-processors for assertions to avoid runner issues with declarative assertions.\n- See `docs/PRACTICAL-USAGE.md` for complete examples.\n\n## Project Structure\n\n```\nsrc/\n  index.ts          Entry point, registers tools and starts MCP server\n  client.ts         ApidogClient HTTP wrapper with auth headers\n  types.ts          Shared TypeScript interfaces and MCP result helpers\n  errors.ts         Custom error classes (ApidogApiError, ApidogConfigError)\n  schemas.ts        Shared Zod schemas for request parameters\n  tools/\n    read.ts         Read-only tools (environments, endpoints, categories, etc.)\n    test-cases.ts   Test case CRUD tools\n    test-scenarios.ts  Test scenario CRUD tools\n    test-suites.ts  Test suite CRUD tools\n    test-data.ts    Test data CRUD tools\n    folders.ts      Folder management tools\n```\n\n## License\n\n[MIT License](LICENSE)\n",
  "bytes": 7696,
  "sha": "bd2ff900758eec89b1f5a973272e293e3b530449779569fdba19c372dc6bb166",
  "repo_slug": "acabala/apidog-tests-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_acabala_apidog_tests_mcp_17beceab/readme"
}