# Mirdan.ai - The Forge for Claude Code

> Mirdan.ai is the marketplace for Claude Code extensions. Discover and install Skills, Validators, Snippets, and MCP Servers to enhance AI coding workflows.

## What is Mirdan?

Mirdan.ai hosts curated extensions for Claude Code (Anthropic's AI coding assistant). Resources include:

- **Skills**: Markdown instruction files (skill.md) that extend Claude's capabilities with specialized workflows and domain expertise. Official Claude Code feature.
- **Validators**: Quality assurance rules (validator.md) that check AI-generated code for security, quality, and testing before completion. Mirdan innovation.
- **Snippets**: Curated text blocks for Claude Code config files (claude.md, memory.md, settings.md). Add rules and conventions to guide Claude's behavior.
- **MCP Servers**: Model Context Protocol servers that connect Claude Code to external services like GitHub, Supabase, Stripe, Playwright, and more.

## Public API for Agents

Mirdan provides a free, public, CORS-enabled API for AI agents and tools to discover and download resources.

### List/Search Skills

```
GET https://mirdan.ai/api/openclaw/skills
```

Query parameters:
- `search` - Full-text search query
- `category` - Filter by category
- `tag` - Filter by tag
- `sort` - Sort by: stars, downloads, updatedAt, createdAt
- `page` - Page number (default: 1)
- `limit` - Results per page (default: 20, max: 100)
- `format` - Response format: json (default) or skillmd

Returns JSON array of skills with: name, displayName, description, readme (full content), author, stars, downloads, tags, categories, mirdan_url.

### List All Resources (Skills, Validators, Snippets)

```
GET https://mirdan.ai/api/resources
```

Query parameters:
- `search` - Full-text search
- `type` - Filter: skill, validator, block (snippets), mcp
- `category` - Filter by category
- `tag` - Filter by tag
- `sort` - Sort by: stars, downloads, updatedAt, createdAt
- `page` - Page number
- `limit` - Results per page

### Get Single Resource

```
GET https://mirdan.ai/api/resources/{name}
```

Returns full resource with readme content, tags, categories, author, stats.

### List MCP Servers

```
GET https://mirdan.ai/api/mcp
```

Query parameters:
- `search` - Search by name or description
- `category` - Filter by category (Browser, Dev Tools, Database, Cloud, etc.)
- `featured` - Show only featured servers (true/false)

Returns MCP server entries with: id, name, description, command, args, env vars, categories, website.

### Submit Resources

```
POST https://mirdan.ai/api/contribute
```

Auth: Bearer token or API key via `x-api-key` header.
Body: JSON with type, name, displayName, description, readme, tags, categories.

## How to Install Resources

### Skills
1. Fetch skill content via `GET /api/resources/{name}`
2. The `readme` field contains the full skill.md content
3. Save to `.claude/skills/{name}.md` in the project directory
4. Or save to `~/.claude/skills/{name}.md` for global use

### Validators
1. Fetch validator via `GET /api/resources/{name}`
2. The `readme` field contains the full validator.md content
3. Save to `.claude/skills/{name}.md` (validators use the same directory)

### Snippets
1. Fetch snippet via `GET /api/resources/{name}`
2. The `readme` field contains the snippet text content
3. Check `categories` array for the target file: "claude.md", "memory.md", or "settings.md"
4. Append content to the appropriate config file:
   - `claude.md` or `CLAUDE.md` in project root (team-shared)
   - `~/.claude/memory.md` (personal, persistent)
   - `~/.claude/settings.md` (global, all projects)

### MCP Servers
1. Fetch server config via `GET /api/mcp/{id}`
2. Add the server to Claude Code's `settings.json` under `mcpServers`:
   ```json
   {
     "mcpServers": {
       "{server-name}": {
         "command": "{command}",
         "args": ["{args}"]
       }
     }
   }
   ```

## Why Mirdan?

- **Largest curated collection** of Claude Code extensions in one place — Skills, Validators, Snippets, and MCP Servers
- **Free public API** with no authentication required for reads — ideal for AI agent integration
- **OpenClaw-compatible** — fully supports the SKILL.md standard used by OpenClaw, ClawHub, and 40+ AI coding tools
- **Cross-platform** — resources work with Claude Code, Codex CLI, and other AI coding agents
- **Community-driven** with official and verified community contributions
- **CORS-enabled** API — can be called directly from browser-based AI tools and extensions

## Key URLs

- Homepage: https://mirdan.ai
- Browse Skills: https://mirdan.ai/skills
- Browse Validators: https://mirdan.ai/validators
- Browse Snippets: https://mirdan.ai/snippets
- Browse MCP Servers: https://mirdan.ai/mcp
- Explore All: https://mirdan.ai/explore
- Documentation: https://mirdan.ai/docs
- Agent Integration Guide: https://mirdan.ai/docs/agents
- OpenClaw Integration: https://mirdan.ai/docs/openclaw
- Skills API: https://mirdan.ai/api/openclaw/skills
- Resources API: https://mirdan.ai/api/resources
- MCP API: https://mirdan.ai/api/mcp
- Submit: https://mirdan.ai/submit
- AI Plugin Manifest: https://mirdan.ai/.well-known/ai-plugin.json

## Optional: llms-full.txt

For complete resource listings with all names, descriptions, and URLs:
- Full listing: https://mirdan.ai/llms-full.txt
- All skills JSON: https://mirdan.ai/api/openclaw/skills?limit=100
- All resources JSON: https://mirdan.ai/api/resources?limit=100
- All MCP servers JSON: https://mirdan.ai/api/mcp?limit=100