~ docs

Documentation

everything you need to use and build for mcp-get.

getting started

mcp-get is a registry for Model Context Protocol tools. install the CLI to discover, install, and publish MCP servers.

# install the cli

$ npm install -g mcp-get

# login to your account

$ mcp-get login

# search and install a tool

$ mcp-get search weather

$ mcp-get install weather

tools install to ~/.mcp/tools/ and auto-register in mcp.json

cli commands

mcp-get loginauthenticate and save your API key
mcp-get search <query>full-text search the tool registry
mcp-get install <slug>download, verify, and install a tool
mcp-get install <slug@version>install a specific version
mcp-get uninstall <slug>remove a tool and clean up config
mcp-get updateupdate all installed tools to latest
mcp-get listshow all installed tools
mcp-get info <slug>view tool details, versions, and status
mcp-get publish <dir>package and publish a tool
mcp-get ask "<query>"ai-powered tool discovery

api reference

base: http://localhost:8000 — openapi docs at /docs

GET/toolssearch and browse tools
GET/tools/tagslist all tags
GET/tools/:slugtool detail
GET/tools/:slug/latestlatest version manifest
POST/toolspublish a new tool
POST/tools/:slug/versionspublish a new version
DELETE/tools/:slugdeprecate a tool
POST/auth/registercreate account
POST/auth/loginlogin and get JWT
POST/auth/api-keygenerate API key
POST/installslog an install
POST/ratingsrate a tool (1-5)

publishing tools

create an mcp.json manifest and run mcp-get publish.

{
  "name": "my-tool",
  "slug": "my-tool",
  "version": "1.0.0",
  "description": "What your tool does",
  "entry": "server.py",
  "tags": ["utilities"]
}

tools are sandboxed: no network, 256 MB memory, 30s timeout, non-root. passes → goes live.

mcp protocol

MCP tools communicate over stdio using JSON-RPC 2.0. your server must handle:

initializereturn server info and capabilities
tools/listreturn array of available tools with input schemas
tools/callexecute a tool with given arguments and return results

see modelcontextprotocol.io for the full spec.

ai discovery

describe what your agent needs in plain english. ai searches the registry and recommends the best tools.

# cli (requires AI_API_KEY)

$ mcp-get ask "I need to query a Postgres database"

# or use the web ui at /discover

security

+tools run in isolated docker containers — never on the api server
+sandbox: no network, read-only fs, 256 MB, non-root
+api keys stored as sha-256 hashes — raw key returned once
+passwords bcrypt-hashed — jwts expire after 1 hour
+tarball checksums (sha-256) verified on download
+publish endpoints are rate-limited