🔌 MCP Protocol Integration
MarketNow exposes every skill via the Model Context Protocol (MCP) — a standard for AI agents to discover, install, and interact with tools and data sources in real time.
🎯 1. Discovery
Any AI agent can discover skills via the open API:
GET https://marketnow.site/api/skills_index.json ← all 13,859 skills
GET https://marketnow.site/api/search?q={query}&cat={cat}&lang={lang} ← filtered
GET https://marketnow.site/api/categories.json ← browse by category
📦 2. Installation
Each skill includes an install command in its metadata. Typical formats:
# Python skills (via uvx)
uvx <skill-slug>
# Node.js / TypeScript skills
npx -y @marketnow/<skill-slug>
# Docker-based skills
docker run marketnow/<skill-slug>
🤖 3. MCP Client Configuration
Copy-paste config for the three most popular MCP clients:
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"marketnow-search": {
"url": "https://marketnow.site/api/search"
}
}
}
Claude Code (~/.claude/settings.json)
{
"mcpServers": {
"marketnow": {
"type": "sse",
"url": "https://marketnow.site/api/search"
}
}
}
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"marketnow": {
"url": "https://marketnow.site/api/search",
"type": "sse"
}
}
}
Once connected, agents can search 13,859 skills in real time:
# Agent prompt:
"Find MCP skills for financial analysis"
# Agent calls:
GET /api/search?q=financial+analysis&cat=Finance
# Returns:
{
"total": 18,
"results": [
{"name":"Stock Analysis MCP", "install":"uvx stock-analysis"},
{"name":"Yahoo Finance MCP", "install":"npx -y yahoo-finance"}
]
}
📋 4. Registration
Skill providers can register new skills via the API:
POST https://marketnow.site/api/register
Content-Type: application/json
{
"name": "My Skill",
"description": "What it does",
"repoUrl": "https://github.com/user/repo",
"email": "creator@example.com",
"category": "AI",
"tags": ["nlp", "text"],
"install": "uvx my-skill"
}
Submissions are reviewed by Alice Sentinel and listed within 24h.
🌐 5. API Endpoints
GET /api/health — Service status
GET /api/skills_index.json — Full catalog
GET /api/search?q=&cat=&lang= — Filtered search
GET /api/categories.json — Categories list
GET /api/manifest.json — API manifest
GET /skill/:slug — SSR skill page
GET /security — Sentinel audit
GET /mcp — This guide
POST /api/register — Submit a skill