API Endpoint Contract
trycompai/comp
The contract every new or modified API endpoint must follow so it is correct for the public OpenAPI spec, the MCP server (npm @trycompai/mcp-server), the ValidationPipe, and the docs.
Build and test MCP tools using direct API calls or MCP Inspector.
Install Test MCP
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install tomaspavlin/rohlik-mcp test-mcp --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/test-mcp .claude/skills/test-mcp && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .claude/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcpType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install tomaspavlin/rohlik-mcp test-mcp --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/test-mcp .agents/skills/test-mcp && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .agents/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install tomaspavlin/rohlik-mcp test-mcp --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/test-mcp .cursor/skills/test-mcp && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .cursor/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/tomaspavlin/rohlik-mcp.git --path .claude/skills/test-mcp--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install tomaspavlin/rohlik-mcp test-mcp --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/test-mcp .gemini/skills/test-mcp && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .gemini/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install tomaspavlin/rohlik-mcp test-mcpInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/test-mcp .github/skills/test-mcp && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .github/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install tomaspavlin/rohlik-mcp test-mcp --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tomaspavlin/rohlik-mcp.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/test-mcp .opencode/skills/test-mcp && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "test-mcp" agent skill from https://github.com/tomaspavlin/rohlik-mcp/tree/main/.claude/skills/test-mcp into .opencode/skills/test-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-mcp", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
test-mcp- GitHub stars
- 121
- Token cost
- ~593 tokens
- SKILL.md length
- 254 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Build and test MCP tools using direct API calls or MCP Inspector.
- Works in 5 steps: Build the project → Call the API directly → MCP Inspector (manual testing) → …
- Testing tool changes
- SKILL.md covers 1. Build the project, 2. Call the API directly, 3. MCP Inspector (manual… and 4. Debugging with console.error, plus 1 more section
- Calls npm and node; needs ROHLIK_PASSWORD
What it does
Test MCP is an agent skill from tomaspavlin/rohlik-mcp. Build and test MCP tools using direct API calls or MCP Inspector. Use when testing tool changes, verifying API responses, debugging MCP tools, or investigating what an API endpoint returns.
Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering MCP servers and REST APIs. It works with Model Context Protocol and npm. The repository describes itself as: MCP server that lets you shop groceries across the Rohlik Group platforms (Rohlik.cz, Knuspr.de, Gurkerl.at, Kifli.hu, Sezamo.ro). The licence is MIT.
When your agent uses it
- Testing tool changes
- Verifying API responses
- Debugging MCP tools
- Investigating what an API endpoint returns
Example prompts
- “/test-mcp”
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 9e824c5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npmnode
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
ROHLIK_PASSWORD
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Test MCP loads about 593 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 254 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:25
PI methods directly using Node with the `.env` file for credentials: - NoteMentions a .env fileSKILL.md:28
node --env-file=.env --input-type=module -e "
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from tomaspavlin/rohlik-mcp at commit 9e824c5, republished under its MIT licence (© tomaspavlin). 254 words, ~593 tokens.
Download SKILL.mdSave it as
.claude/skills/test-mcp/SKILL.md (or your agent's skills folder).- name
- test-mcp
- description
- Build and test MCP tools using direct API calls or MCP Inspector. Use when testing tool changes, verifying API responses, debugging MCP tools, or investigating what an API endpoint returns.
- disable-model-invocation
- false
- argument-hint
- [tool-name]
Testing MCP Tools
Use this skill whenever you need to:
- Investigate what an API endpoint returns (e.g. before updating a tool's field mappings)
- Verify that tool changes correctly map API response fields
- Debug why a tool returns wrong or missing data
- Test tool changes after implementation
1. Build the project
Run npm run build to compile TypeScript. Fix any compilation errors before proceeding.
2. Call the API directly
Call API methods directly using Node with the .env file for credentials:
node --env-file=.env --input-type=module -e "
import { RohlikAPI } from './dist/rohlik-api.js';
const api = new RohlikAPI({ username: process.env.ROHLIK_USERNAME, password: process.env.ROHLIK_PASSWORD });
const result = await api.methodName(args);
console.log(JSON.stringify(result, null, 2));
"Replace methodName and args with the appropriate API method. Check src/rohlik-api.ts for available methods.
This lets you inspect the raw API response shape to understand what fields are available, verify field names, and confirm your tool's output matches the actual data.
3. MCP Inspector (manual testing)
If the user wants to test the full MCP tool flow (not just the API), tell them to run npm run inspect in a separate terminal. The Inspector provides a web UI to invoke individual MCP tools with custom arguments.
If the user provides a specific tool name via $ARGUMENTS, suggest they test that tool.
4. Debugging with console.error
MCP servers communicate over stdout (used for the JSON-RPC protocol), so console.log output is invisible in the Inspector.
Always use console.error for debug logging. It writes to stderr, which is visible in the terminal where the Inspector was launched.
Example:
console.error('[ROHLIK_DEBUG] Response:', JSON.stringify(response, null, 2));Remember to remove debug logging before committing.
5. Unit tests
For logic-only changes (no API calls), run npm test to execute unit tests. Use npm run test:watch during development.
© tomaspavlin, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .claude/skills/test-mcp of tomaspavlin/rohlik-mcp.
Open the folder on GitHubat commit 9e824c5
Compare with similar skills
Test MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Test MCP this skilltomaspavlin/rohlik-mcp | 121 | — | ~593 | Automated safety check: Notes | MIT | |
| API Endpoint Contracttrycompai/comp | 2k | — | ~2.7k | Automated safety check: Pass | AGPL-3.0 | |
| MCP Server BuildershareAI-lab/learn-claude-code | 78k | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Yahoo Finance2gadicc/yahoo-finance2 | 801 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Workflow Schema Tuningbreaking-brake/cc-wf-studio | 5.4k | — | ~1.3k | Automated safety check: Pass | Custom licence | |
| Paseo Plugin Buildergetpaseo/paseo | 20k | — | ~9.4k | Automated safety check: Pass | Custom licence |
Similar skills
MCP Server Builder
shareAI-lab/learn-claude-code
Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.
Yahoo Finance2
gadicc/yahoo-finance2
A skill your agent uses when building with the yahoo-finance2 TypeScript/Deno/npm library, using its Yahoo Finance data modules, CLI, or MCP server, or contributing to the yahoo-finance2 repository…
Workflow Schema Tuning
breaking-brake/cc-wf-studio
Guides edits to cc-wf-studio's workflow schema so AI agents generate better workflows, treating schema text as prompt engineering rather than validation.
Paseo Plugin Builder
getpaseo/paseo
Builds, installs and troubleshoots trusted local Paseo plugins, from lifecycle hooks and slash commands to screens, themes and timeline renderers.
- Official
MCP Apps Builder
awslabs/cli-agent-orchestrator
Load the official MCP Apps builder skills (create-mcp-app, migrate-oai-app, add-app-to-server, convert-web-app) from github.com/modelcontextprotocol/ext-apps.
More from tomaspavlin/rohlik-mcp
Publish
tomaspavlin/rohlik-mcp
Publish a new version of the npm package. An agent skill from tomaspavlin/rohlik-mcp.
Related
Works with
Categories
Questions about Test MCP
What does Test MCP do?
Build and test MCP tools using direct API calls or MCP Inspector. Test MCP is an agent skill from tomaspavlin/rohlik-mcp. Build and test MCP tools using direct API calls or MCP Inspector.
When should I use Test MCP?
Test MCP fits situations like: testing tool changes; verifying API responses; debugging MCP tools; investigating what an API endpoint returns.
How do I install Test MCP in Claude Code?
Run `npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a claude-code`. Or copy the skill folder (.claude/skills/test-mcp in tomaspavlin/rohlik-mcp) into .claude/skills/test-mcp in your project. Claude Code loads it when a task matches its description.
How do I install Test MCP in Codex?
Run `npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a codex`. Or copy the skill folder (.claude/skills/test-mcp in tomaspavlin/rohlik-mcp) into .agents/skills/test-mcp in your project. Codex loads it when a task matches its description.
Can I use Test MCP in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tomaspavlin/rohlik-mcp --skill test-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/test-mcp, .gemini/skills/test-mcp, .github/skills/test-mcp and .opencode/skills/test-mcp in your project.
What does Test MCP need to run?
Going by SKILL.md and its folder, Test MCP needs the command-line tools its instructions call (npm and node) and credentials named ROHLIK_PASSWORD.
Does Test MCP access the network?
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Test MCP safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Test MCP use?
Test MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Test MCP use?
About 593 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Test MCP?
Skills that share tags, products or a category with Test MCP: API Endpoint Contract (trycompai/comp, 2k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), Yahoo Finance2 (gadicc/yahoo-finance2, 801 stars) and Workflow Schema Tuning (breaking-brake/cc-wf-studio, 5.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Test MCP?
tomaspavlin (a GitHub user) maintains it in tomaspavlin/rohlik-mcp, which has 121 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on March 17, 2026.
Source: tomaspavlin/rohlik-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.