# LaunchNests MCP Server

> Public, read-only Model Context Protocol tools for the LaunchNests developer tools and software directory. No API key required.

```yaml
url: "https://launchnests.com/mcp"
transport: "https://launchnests.com/api/mcp"
alias: "https://launchnests.com/mcp"
server_card: "https://launchnests.com/.well-known/mcp/server-card.json"
mcp_json: "https://launchnests.com/.well-known/mcp.json"
ai_snapshot: "https://launchnests.com/api/ai"
auth: none - public read-only
protocol: JSON-RPC 2.0 over HTTP POST
tools: 5
```

## Start Here

- Site map: [llms.txt](https://launchnests.com/llms.txt) — do not guess URLs.
- Bounded catalog snapshot: [GET /api/ai](https://launchnests.com/api/ai) — trending tools + products.
- Tool calls: POST JSON-RPC to [MCP endpoint](https://launchnests.com/api/mcp).
- Any public page also has a markdown twin — append `.md` or send `Accept: text/markdown`. Catalog: [/api/md/_catalog](https://launchnests.com/api/md/_catalog).

## Available Tools

1. `search_tools` — Keyword search across developer tools. Args: `query` (required), `limit` (default 10).
2. `search_products` — Search developer-built products and inspect declared tech stacks. Args: `query` (required), `limit` (default 10).
3. `get_tool` — Fetch specifications and verified builds count for a tool by slug. Args: `slug` (required).
4. `get_product` — Fetch problem, solution, unique value, and tech stack for a product by slug. Args: `slug` (required).
5. `get_leaderboard` — Fetch community-upvoted developer tools or trending products. Args: `type` ('tools' | 'products'), `limit` (default 20).
6. `get_maker_profile` — Fetch developer bio, location, maker FAQs, and submitted tools/products by username. Args: `username` (required).
7. `get_daily_launches` — Fetch developer tools and products launching today, ranked by community votes. Args: `limit` (default 20).
8. `get_weekly_launches` — Fetch developer tools and products launched this week, ranked by community votes. Args: `limit` (default 20).

## How to Connect

### Cursor Setup (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "launchnests": {
      "url": "https://launchnests.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}
```

### Claude Desktop / Claude Code

```json
{
  "mcpServers": {
    "launchnests": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://launchnests.com/api/mcp"]
    }
  }
}
```

## JSON-RPC Example

### initialize

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "ai-assistant", "version": "1.0.0" }
  }
}
```

### tools/call — search_tools

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_tools",
    "arguments": { "query": "database", "limit": 5 }
  }
}
```
