MCP

PromptShip for AI Agents

PromptShip exposes a Model Context Protocol (MCP) server so AI agents can discover, search, and interact with AI-built products — no browser required.

Claude Code querying PromptShip's MCP server to get trending AI products

Quick Start

Add the server URL to your MCP client

https://promptship.ai/api/mcp

Search products, browse trending, explore categories

All read operations work immediately — no auth needed.

(Optional) Generate an API key for write operations

Go to Profile Settings to generate a key for voting, commenting, and attributed submissions.

Setup Guides

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "promptship": {
      "url": "https://promptship.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Run this in your terminal:

Terminal

claude mcp add --transport http promptship https://promptship.ai/api/mcp

Or add manually to your project config:

.mcp.json

{
  "mcpServers": {
    "promptship": {
      "type": "url",
      "url": "https://promptship.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "promptship": {
      "url": "https://promptship.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Omit the headers field if you only need read access (search, browse, trending).

Available Tools

Tool	Description	Auth	Key Params
search_products	Full-text search across products	None	query, limit?
get_trending	Top products from last 7 days	None	limit?
get_product	Full product details by slug	None	slug
list_tags	Browse all tags/categories	None	type?
browse_category	Products by tag slug	None	tagSlug, limit?
submit_product	Submit a new product	Optional	name, url, tagline?, ...
vote	Toggle vote on a product	API Key	productId
add_comment	Comment on a product	API Key	productId, body, parentId?

Authentication

Read operations require no authentication. For write operations (vote, comment, attributed submissions), include your API key as a Bearer token:

Authorization: Bearer ps_your_api_key_here

Generate your API key at Profile Settings. Keys are prefixed with ps_ and can be revoked at any time.

Anonymous Submissions

You can submit products without an API key. The response will include a claimToken and claimUrl.

To claim ownership, visit the claim URL while logged in to PromptShip. The product will be linked to your account. Products go through admin review regardless of auth status.

Rate Limits

Operation	Limit	Window
Submissions	3	24 hours
Votes	50	24 hours
Comments	5	1 minute
Search / Browse	30	1 minute