marketnow-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MarketNow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,124 @@
+# MarketNow MCP Server
+
+> Search, discover, and install MCP skills from any agent runtime.
+
+[![npm version](https://img.shields.io/npm/v/marketnow-mcp.svg)](https://www.npmjs.com/package/marketnow-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+The [MarketNow](https://marketnow.site) marketplace as an MCP server. Allows any MCP-compatible agent (Claude Desktop, Cursor, Cline, etc.) to search and discover skills directly from their runtime — without leaving the conversation.
+
+## Install
+
+```bash
+npm install -g marketnow-mcp
+```
+
+Or use directly with npx (no install needed):
+
+```bash
+npx marketnow-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "marketnow": {
+      "command": "npx",
+      "args": ["-y", "marketnow-mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to Settings → MCP:
+
+```json
+{
+  "mcpServers": {
+    "marketnow": {
+      "command": "npx",
+      "args": ["-y", "marketnow-mcp"]
+    }
+  }
+}
+```
+
+### Cline / VS Code
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "marketnow": {
+      "command": "npx",
+      "args": ["-y", "marketnow-mcp"],
+      "env": {}
+    }
+  }
+}
+```
+
+## Tools Exposed
+
+| Tool | Description |
+|---|---|
+| `search_skills` | Search skills by query, category, or max price |
+| `get_skill` | Get full details of a specific skill |
+| `list_categories` | List all 25 categories with counts |
+| `get_manifest` | Get marketplace metadata (totals, pricing) |
+| `get_install_command` | Get the npx install command for a skill |
+
+## Example Usage
+
+Once connected, you can ask Claude:
+
+- "Find me a skill to scrape websites and extract prices"
+- "What's the cheapest AI/ML skill on MarketNow?"
+- "Show me all skills in the Security category"
+- "Get the install command for mn-ai-00001"
+
+Claude will use the MarketNow MCP server to search the marketplace and return results with prices, descriptions, and install commands.
+
+## How It Works
+
+The MCP server fetches the public API at `https://marketnow.site/api/skills.json` (cached for 1 hour). It exposes 5 tools that agents can call to discover skills without leaving their runtime.
+
+- **No API key required** for read operations
+- **CORS-enabled** — works from browser and Node.js
+- **1-hour cache** — minimizes bandwidth and latency
+- **5,000+ skills** — the largest curated MCP skill catalog
+
+To purchase a skill, the agent opens the buy URL in a browser.
+
+## Pricing
+
+All skills on MarketNow are micro-priced:
+
+- **$0.99** — utility, single-function MCP servers
+- **$1.99** — standard integrations
+- **$2.99** — multi-feature tools (most common)
+- **$4.99** — sophisticated multi-endpoint tools
+- **$9.99** — enterprise-grade, specialized
+
+Average price: **$2.50**. One-time payment, lifetime license. No subscriptions.
+
+## Links
+
+- **Website**: [https://marketnow.site](https://marketnow.site)
+- **Registry**: [https://marketnow.site/registry](https://marketnow.site/registry)
+- **Submit a skill**: [https://marketnow.site/submit](https://marketnow.site/submit)
+- **API docs**: [https://marketnow.site/api/agent.json](https://marketnow.site/api/agent.json)
+- **GitHub**: [https://github.com/edgarfloresguerra2011-a11y/marketnow](https://github.com/edgarfloresguerra2011-a11y/marketnow)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+/**
+ * MarketNow MCP Server
+ * ====================
+ *
+ * El propio MarketNow como un MCP server. Permite a cualquier agente
+ * compatible con MCP (Claude, Cursor, etc.) buscar y descubrir skills
+ * del marketplace directamente desde su runtime.
+ *
+ * Herramientas expuestas:
+ *  - search_skills(query, category?, max_price?) → lista de skills matching
+ *  - get_skill(skill_id) → detalle de una skill específica
+ *  - list_categories() → todas las categorías con count
+ *  - get_manifest() → metadata del marketplace (totals, pricing, etc.)
+ *  - get_install_command(skill_id) → comando npx para instalar la skill
+ *
+ * Uso:
+ *   npx @marketnow/mcp-server
+ *
+ * O añadir a tu agente (ej. Claude Desktop):
+ *   {
+ *     "mcpServers": {
+ *       "marketnow": {
+ *         "command": "npx",
+ *         "args": ["-y", "@marketnow/mcp-server"]
+ *       }
+ *     }
+ *   }
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+const API_BASE = 'https://marketnow.site/api';
+
+// ─── Fetch helpers ──────────────────────────────────────────────────────────
+let skillsCache = null;
+let cacheTime = 0;
+const CACHE_TTL = 3600_000; // 1 hour
+
+async function fetchSkills() {
+  if (skillsCache && Date.now() - cacheTime < CACHE_TTL) {
+    return skillsCache;
+  }
+  const res = await fetch(`${API_BASE}/skills.json`);
+  if (!res.ok) throw new Error(`Failed to fetch skills: ${res.status}`);
+  skillsCache = await res.json();
+  cacheTime = Date.now();
+  return skillsCache;
+}
+
+async function fetchManifest() {
+  const res = await fetch(`${API_BASE}/manifest.json`);
+  if (!res.ok) throw new Error(`Failed to fetch manifest: ${res.status}`);
+  return res.json();
+}
+
+async function fetchCategories() {
+  const res = await fetch(`${API_BASE}/categories.json`);
+  if (!res.ok) throw new Error(`Failed to fetch categories: ${res.status}`);
+  return res.json();
+}
+
+// ─── Tool implementations ───────────────────────────────────────────────────
+async function searchSkills(args) {
+  const { query = '', category, max_price, limit = 10 } = args;
+  const skills = await fetchSkills();
+
+  let results = skills;
+
+  if (category) {
+    results = results.filter(s => s.category?.toLowerCase() === category.toLowerCase());
+  }
+
+  if (max_price !== undefined) {
+    results = results.filter(s => s.price <= max_price);
+  }
+
+  if (query) {
+    const q = query.toLowerCase();
+    results = results
+      .map(s => {
+        const nameMatch = (s.name || '').toLowerCase().includes(q) ? 10 : 0;
+        const descMatch = (s.description || '').toLowerCase().includes(q) ? 5 : 0;
+        const tagMatch = (s.tags || []).some(t => String(t).toLowerCase().includes(q)) ? 8 : 0;
+        const score = nameMatch + descMatch + tagMatch;
+        return { skill: s, score };
+      })
+      .filter(x => x.score > 0)
+      .sort((a, b) => b.score - a.score)
+      .slice(0, limit)
+      .map(x => x.skill);
+  } else {
+    results = results.slice(0, limit);
+  }
+
+  return {
+    count: results.length,
+    skills: results.map(s => ({
+      id: s.id,
+      name: s.name,
+      slug: s.slug,
+      description: s.description?.slice(0, 200),
+      category: s.category,
+      price: s.price,
+      currency: s.currency || 'USD',
+      install: s.install,
+      sentinel_score: s.sentinel_score,
+      url: `https://marketnow.site/skill/${s.id}`,
+    })),
+  };
+}
+
+async function getSkill(args) {
+  const { skill_id } = args;
+  if (!skill_id) throw new Error('skill_id is required');
+  const skills = await fetchSkills();
+  const skill = skills.find(s => s.id === skill_id || s.slug === skill_id);
+  if (!skill) throw new Error(`Skill not found: ${skill_id}`);
+  return {
+    ...skill,
+    url: `https://marketnow.site/skill/${skill.id}`,
+    buy_url: `https://marketnow.site/skill/${skill.id}`,
+  };
+}
+
+async function listCategories() {
+  return await fetchCategories();
+}
+
+async function getInstallCommand(args) {
+  const { skill_id } = args;
+  if (!skill_id) throw new Error('skill_id is required');
+  const skills = await fetchSkills();
+  const skill = skills.find(s => s.id === skill_id || s.slug === skill_id);
+  if (!skill) throw new Error(`Skill not found: ${skill_id}`);
+  return {
+    skill_id: skill.id,
+    name: skill.name,
+    install_command: skill.install || `npx -y @marketnow/install ${skill.slug}`,
+    price: skill.price,
+    currency: skill.currency || 'USD',
+    note: `Buy this skill at https://marketnow.site/skill/${skill.id} to get a license key, then run the install command.`,
+  };
+}
+
+// ─── MCP Server setup ───────────────────────────────────────────────────────
+const server = new Server(
+  {
+    name: 'marketnow',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'search_skills',
+      description: 'Search the MarketNow marketplace for MCP-compatible skills. Returns matching skills with price, category, and install command. Use this when an agent or user needs to find a tool for a specific task.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          query: {
+            type: 'string',
+            description: 'Natural language or keyword search (e.g. "scrape website", "discord bot", "database query")',
+          },
+          category: {
+            type: 'string',
+            description: 'Filter by category (optional). One of: AI/ML, Data, Web/API, Security, DevOps, Communication, etc.',
+          },
+          max_price: {
+            type: 'number',
+            description: 'Maximum price in USD (optional, e.g. 2.99)',
+          },
+          limit: {
+            type: 'number',
+            description: 'Max results to return (default 10, max 50)',
+            default: 10,
+          },
+        },
+      },
+    },
+    {
+      name: 'get_skill',
+      description: 'Get full details of a specific skill by ID or slug.',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          skill_id: {
+            type: 'string',
+            description: 'Skill ID (e.g. mn-ai-00001) or slug',
+          },
+        },
+        required: ['skill_id'],
+      },
+    },
+    {
+      name: 'list_categories',
+      description: 'List all skill categories with counts.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'get_manifest',
+      description: 'Get marketplace metadata: total skills, pricing tiers, API endpoints.',
+      inputSchema: { type: 'object', properties: {} },
+    },
+    {
+      name: 'get_install_command',
+      description: 'Get the install command for a skill (to run after purchasing).',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          skill_id: {
+            type: 'string',
+            description: 'Skill ID or slug',
+          },
+        },
+        required: ['skill_id'],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    let result;
+    switch (name) {
+      case 'search_skills':
+        result = await searchSkills(args || {});
+        break;
+      case 'get_skill':
+        result = await getSkill(args || {});
+        break;
+      case 'list_categories':
+        result = await listCategories();
+        break;
+      case 'get_manifest':
+        result = await getManifest();
+        break;
+      case 'get_install_command':
+        result = await getInstallCommand(args || {});
+        break;
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  } catch (err) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Error: ${err.message}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// ─── Start server ───────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error('MarketNow MCP Server running on stdio');

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "marketnow-mcp",
+  "version": "1.0.0",
+  "description": "MarketNow MCP Server — search, discover, and install MCP skills from any agent runtime (Claude Desktop, Cursor, Cline)",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "marketnow-mcp": "index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "dev": "node --watch index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "marketplace",
+    "agent-skills",
+    "ai",
+    "claude",
+    "cursor",
+    "cline",
+    "marketnow",
+    "mcp-server"
+  ],
+  "author": "MarketNow <eddyflores100@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://marketnow.site",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/edgarfloresguerra2011-a11y/marketnow.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/edgarfloresguerra2011-a11y/marketnow/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ]
+}