Skip to main content
Exécutez n'importe quel Skill dans Manus
en un clic
developers.md
Developer Portal
Agent-Ready API

# Developer Portal

Integrate with the SkillsMP API to discover 1.2M+ Claude Code skills programmatically. Build agent-ready applications with our REST API, MCP server, and OpenAPI specification.

quickstart.md

Quickstart Guide

1

Get an API Key

Sign in and generate your API key from the dashboard. Anonymous access is also available with lower rate limits.

2

Make your first request

Search skills using the REST API. Replace YOUR_API_KEY with your actual key, or omit the header for anonymous access.

bash
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=SEO" \
  -H "Authorization: Bearer YOUR_API_KEY"
javascript
const response = await fetch(
  'https://skillsmp.com/api/v1/skills/search?q=SEO',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);
const data = await response.json();
console.log(data.data.skills);
python
import requests

response = requests.get(
    'https://skillsmp.com/api/v1/skills/search',
    params={'q': 'SEO'},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(data['data']['skills'])
3

Explore the API

Read the full API documentation for detailed endpoint references, error codes, and rate limiting information.

Read API Documentation
mcp.md

MCP Server

SkillsMP exposes a Model Context Protocol (MCP) server, allowing AI agents like Claude and ChatGPT to search and discover skills natively. Use Streamable HTTP transport for seamless integration.

Server Endpoint

POST https://skillsmp.com/mcp

Discovery

GET https://skillsmp.com/.well-known/mcp/server-card.json

Available Tools

search_skills

Search skills by keyword with filters

get_skill

Get detailed information about a specific skill

list_categories

Browse all skill categories and domains

ai_search_skills

Semantic search using natural language

sandbox.md

API Sandbox

Test the API directly in your browser. No API key required for basic search (anonymous quota: 50 requests/day).

agent-auth.md

AI Agent Authentication

Step-by-step guide for AI agents (Claude, ChatGPT, autonomous pipelines, bots) to authenticate programmatically with the SkillsMP API. No OAuth or user interaction required at runtime — agents use long-lived API keys.

1

Provision an API key (one-time, human-in-the-loop)

The owning human signs in at /auth/login (Google or GitHub), opens the Developer Portal dashboard, and generates an API key. Store the key in the agent's secret manager (env var, vault, KMS).

2

Send the key on every request

Add the Authorization header. Treat the key as a bearer token — do not put it in the URL, query string, or client-side code.

http
Authorization: Bearer sk_live_your_api_key
3

Handle rate limits gracefully

Every response includes X-RateLimit-Daily-Remaining and X-RateLimit-Minute-Remaining. On 429, read the header, back off, and retry. Anonymous: 50/day · 10/min. Authenticated: 500/day · 30/min.

python
# Python: back off when remaining <= 0
r = requests.get(url, headers={'Authorization': f'Bearer {API_KEY}'})
if r.status_code == 429:
    time.sleep(60)  # wait for the minute window to reset
    r = requests.get(url, headers={'Authorization': f'Bearer {API_KEY}'})
4

Identify your agent (recommended)

Set a descriptive User-Agent so we can reach you if we detect issues. Example: SkillsMPClient/1.0 (+https://your-agent.example)

5

Prefer MCP for tool-calling agents

If your agent supports Model Context Protocol, connect to https://skillsmp.com/mcp instead of hand-rolling REST calls. MCP handles tool discovery, schema, and tool-use loops natively.

Security: API keys do not expire. Rotate from the Developer Portal if exposed. Anonymous requests (no key) work for keyword search but are heavily rate-limited and not recommended for production agents.

webhooks.md

Webhooks

SkillsMP does not currently emit outbound webhooks for new-skill or update events. Agents that need to track the catalog should poll the endpoints below — the ETL pipeline refreshes hourly, so a 1-hour cadence is sufficient for most use cases.

Poll for new/updated skills

Use sortBy=recent and compare the updatedAt timestamp to your last-seen cursor.

http
GET /api/v1/skills/search?q=*&sortBy=recent&limit=50

Subscribe via MCP (push-style)

MCP-enabled agents can call search_skills on a timer and stream results into their context — no outbound HTTPS endpoint required on your side.

Timeline feed

For aggregate growth/update trends, use the public timeline feed:

http
GET /api/timeline?granularity=daily&limit=30

Roadmap: Outbound webhooks for new-skill and update events are planned. If you have a concrete use case, open an issue on GitHub or reach us via the About page so we can prioritize.

policies.md

Rate Limits & Policies

Anonymous Access

  • Daily quota: 50 requests
  • Burst limit: 10 requests/minute (search only)
  • No API key required

Authenticated Access

  • Daily quota: 500 requests
  • Burst limit: 30 requests/minute (search only)
  • API key required in Authorization header