skillmd — Claude Code MCP server: features and setup
Search the SkillMD registry, inspect skills, run checks, and install them through an MCP-capable agent. Useful when you want to find or vet a SKILL.md in chat.
claude mcp add --transport http skillmd https://api.skillmd.com/mcpWhat skillmd does
With skillmd connected, an agent can look up entries in the SkillMD registry, inspect a skill, check it, and install it. That puts registry tasks in the conversation instead of requiring a separate terminal workflow.
For Claude Code, connect over HTTP with claude mcp add --transport http skillmd https://api.skillmd.com/mcp. You can also run the server locally using npx -y skillmds, with SKILLMD_TOKEN and SKILLMD_API supplied as environment variables. The local setup needs values for both.
What it helps with
- search the registry for a skill
- inspect a skill before installing it
- check a skill for format issues
- install a registry skill through an agent
Example prompts for the agent
- Find a SkillMD skill for working with PDF files.
- Check this skill before installing it and explain any issues.
- Install the
anthropic/pdfskill.
How to install skillmd
1Platform CLI: remote server
claude mcp add --transport http skillmd https://api.skillmd.com/mcp2Platform CLI
claude mcp add --env SKILLMD_TOKEN=<SKILLMD_TOKEN> --env SKILLMD_API=<SKILLMD_API> --transport stdio skillmd -- npx -y skillmdsReplace <…> with your own values
1Platform CLI: remote server
codex mcp add skillmd --url https://api.skillmd.com/mcp2Platform CLI
codex mcp add skillmd --env SKILLMD_TOKEN=<SKILLMD_TOKEN> --env SKILLMD_API=<SKILLMD_API> -- npx -y skillmdsReplace <…> with your own values
Config file
{
"mcpServers": {
"skillmd": {
"url": "https://api.skillmd.com/mcp"
}
}
}{
"mcpServers": {
"skillmd": {
"command": "npx",
"args": [
"-y",
"skillmds"
],
"env": {
"SKILLMD_TOKEN": "<SKILLMD_TOKEN>",
"SKILLMD_API": "<SKILLMD_API>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"skillmd": {
"type": "http",
"url": "https://api.skillmd.com/mcp"
}
}
}{
"servers": {
"skillmd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"skillmds"
],
"env": {
"SKILLMD_TOKEN": "<SKILLMD_TOKEN>",
"SKILLMD_API": "<SKILLMD_API>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http skillmd https://api.skillmd.com/mcp2Platform CLI
gemini mcp add -e SKILLMD_TOKEN=<SKILLMD_TOKEN> -e SKILLMD_API=<SKILLMD_API> skillmd npx -y skillmdsReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about skillmd
How do I install skillmd in Claude Code?
Add the HTTP MCP server with claude mcp add --transport http skillmd https://api.skillmd.com/mcp.
What does skillmd do?
It lets an agent search the SkillMD registry, inspect skills, check them, and install them during a conversation.
Do I need tokens to connect skillmd?
The local npx -y skillmds setup uses SKILLMD_TOKEN and SKILLMD_API environment values. The HTTP setup uses the server address in its command.
