Plug and Ship

Official4 tools

by plugandship · TypeScript

Search MCP servers, agent skills and coding-agent plugins: trending tools and best-of lists.

The dev.plugandship/plugandship-mcp MCP server helps users search MCP servers, agent skills, and coding-agent plugins. Its description indicates it surfaces trending tools and best-of lists, using those categories to organize results for developers looking for available integrations.

🛠️ Key Features

Search for MCP servers
Search for agent skills
Search for coding-agent plugins
Provides trending tools
Provides best-of lists

🚀 Use Cases

Find relevant MCP servers
Discover agent skills for coding agents
Identify coding-agent plugins
Browse trending tools
Review best-of lists

⚡ Developer Benefits

Centralized search across MCP servers, skills, and plugins
Tool discovery via trending and curated lists

⚠️ Limitations

Available details are limited to the provided description; no tool names, capabilities, or API surface are specified.

Topics

agent-skillsclaude-codecursormcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

search_tools

Find MCP servers, agent skills (SKILL.md) and coding-agent plugins for a task. Pass a plain-language task (e.g. 'query my Postgres from Cursor', 'post to Slack from Claude Code') or keywords. The task is parsed for kind (MCP/skill/plugin), client (Cursor, Claude Code, Codex, VS Code), remote vs local and language; results are ranked by relevance (full-text + semantic match), with stars, recent commits, a valid one-click config and a license only as tie-breakers. Every result explains why it matches. type, client and remote are strict filters (client grok-bot = MCP servers with a public HTTPS endpoint).

Parameters6

query	string	optional	Keywords or a short task, e.g. 'postgres', 'browser automation', 'query my Postgres from Cursor'
task	string	optional	What you want to do, in plain language. Used instead of query when given.
type	string	optional	Only this kind of tool
client	string	optional	Only tools that name this coding agent (grok-bot: hosted HTTPS MCP servers)
remote	boolean	optional	Only MCP servers with a public HTTPS endpoint (nothing to install)
limit	integer	optional	Max results, default 10

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keywords or a short task, e.g. 'postgres', 'browser automation', 'query my Postgres from Cursor'",
      "type": "string",
      "maxLength": 300
    },
    "task": {
      "description": "What you want to do, in plain language. Used instead of query when given.",
      "type": "string",
      "maxLength": 300
    },
    "type": {
      "description": "Only this kind of tool",
      "type": "string",
      "enum": [
        "mcp",
        "skill",
        "plugin"
      ]
    },
    "client": {
      "description": "Only tools that name this coding agent (grok-bot: hosted HTTPS MCP servers)",
      "type": "string",
      "enum": [
        "claude-code",
        "cursor",
        "codex",
        "grok-bot"
      ]
    },
    "remote": {
      "description": "Only MCP servers with a public HTTPS endpoint (nothing to install)",
      "type": "boolean"
    },
    "limit": {
      "description": "Max results, default 10",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tool

Full details for one tool by its Plug and Ship slug (from search_tools): description, stars, install command, remote endpoint, license, tags and last commit.

Parameters1

slug

string

required

Tool slug, e.g. 'github-mcp-server'

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,120}$",
      "description": "Tool slug, e.g. 'github-mcp-server'"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "description": "Time window"
    },
    "type": {
      "type": "string",
      "enum": [
        "mcp",
        "skill",
        "plugin"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "period"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_best

A ranked best-of list by topic, e.g. 'grok-bot-connectors', 'voice-agents', 'local-models', 'figma-mcp-servers', 'mcp-servers-for-databases'. Omit topic to list all topics.

Parameters2

topic	string	optional	Topic slug; omit to list topics
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic slug; omit to list topics",
      "type": "string",
      "pattern": "^[a-z0-9-]{2,80}$"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md4 KBView on GitHub

plugandship-mcp

An MCP server for Plug and Ship. It lets your coding agent search the Plug and Ship index of MCP servers, agent skills and coding-agent plugins without leaving the chat.

It is read-only. It calls the public Plug and Ship API (/api/v1) and needs no API key.

Listed in the official MCP Registry as dev.plugandship/plugandship-mcp.

Tools

Tool	Arguments	What it returns
`search_tools`	`query`, `type?` (`mcp` / `skill` / `plugin`), `client?` (`claude-code` / `cursor` / `codex` / `grok-bot`), `limit?` (1 to 50, default 10)	Matching tools with stars, install command and page link. `client: "grok-bot"` keeps only MCP servers with a public remote (HTTP) endpoint.
`get_tool`	`slug`	Full details for one tool: description, repo, stars, tags, install command, remote endpoint if any.
`trending`	`period` (`day` / `week` / `month`), `type?`, `limit?`	Repos created in the period, ranked by stars per day.
`list_best`	`topic?`, `limit?`	A curated "best of" list. Leave `topic` empty to list topics (for example `grok-bot-connectors`, `voice-agents`, `postgres-mcp-servers`).

Use the hosted endpoint (no install)

Remote MCP server, Streamable HTTP, stateless, no auth:

code

https://plugandship.dev/mcp

Claude Code

bash

claude mcp add --transport http plugandship https://plugandship.dev/mcp

Cursor (~/.cursor/mcp.json or .cursor/mcp.json in a project)

json

{
  "mcpServers": {
    "plugandship": { "url": "https://plugandship.dev/mcp" }
  }
}

Codex (~/.codex/config.toml)

toml

[mcp_servers.plugandship]
url = "https://plugandship.dev/mcp"

Run it locally (stdio)

Requires Node.js 18 or newer. Runs straight from GitHub, no npm package needed (the built dist/ is committed):

bash

npx -y github:plugandship/plugandship-mcp

Claude Code

bash

claude mcp add plugandship -- npx -y github:plugandship/plugandship-mcp

Cursor

json

{
  "mcpServers": {
    "plugandship": {
      "command": "npx",
      "args": ["-y", "github:plugandship/plugandship-mcp"]
    }
  }
}

Codex

toml

[mcp_servers.plugandship]
command = "npx"
args = ["-y", "github:plugandship/plugandship-mcp"]

From a checkout

bash

git clone https://github.com/plugandship/plugandship-mcp
cd plugandship-mcp
npm install
npm run build
node dist/index.js

Self-host Streamable HTTP

bash

node dist/index.js --http --port 3333 --host 127.0.0.1
# endpoint: http://127.0.0.1:3333/mcp

Stateless, JSON responses, POST only. Requests with a browser Origin other than localhost are rejected. It binds to 127.0.0.1 by default. Put it behind HTTPS before exposing it anywhere.

Configuration

Env var	Default	Purpose
`PLUGANDSHIP_API_URL`	`https://plugandship.dev`	API base URL (use `http://localhost:3000` against a local site).

The public API is cached and rate-limited (about 60 requests per minute per IP). On a 429 the tool returns a short "try again in a minute" error.

Test

bash

npm test                                            # stdio + local HTTP, against https://plugandship.dev
PLUGANDSHIP_API_URL=http://localhost:3000 npm test  # against a local site
MCP_REMOTE_URL=https://plugandship.dev/mcp npm run test:remote  # the hosted endpoint

npm test builds the server, starts it over stdio and over Streamable HTTP, connects with the official MCP SDK client, lists the tools and calls each one, including error cases (unknown slug, invalid input, foreign Origin). test:remote runs the same checks against a remote endpoint.

Registry

server.json is the MCP Registry entry: a remote-only listing (streamable-http, https://plugandship.dev/mcp) under the dev.plugandship namespace, verified by DNS.

License

MIT

Install

Tools (4)

search_toolsget_tooltrendinglist_best

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://plugandship.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "plugandship-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://plugandship.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

period	string	required	Time window
type	string	optional
limit	integer	optional

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_tools

get_tool

trending

list_best

plugandship-mcp

Tools

Use the hosted endpoint (no install)

Run it locally (stdio)

From a checkout

Self-host Streamable HTTP

Configuration

Test

Registry

License

Install

Remote endpoint

Related servers