👻 Ghostclip.dev — MCP & API
Connect your AI assistant in under 2 minutes.
Ghostclip.dev provides both a REST API and a remote MCP (Model Context Protocol) server so AI assistants and automations can create, read, update and delete encrypted ephemeral clipboards. The MCP server runs directly on ghostclip.dev — no local installation required, just a URL and an API key.
1 Get your API key
Go to /mcp, enter your clipboard code, and click Generate key. Your key starts with gc_. Keep it safe — it is shown only once.
2 Connect your client
REST API
Use these endpoints from any HTTP client, script, or automation. All requests require Authorization: Bearer <your_api_key>.
| Method | Path | Action |
|---|---|---|
| POST | /api/v1/clipboard | Create clipboard → returns {code, url, expires_at} |
| GET | /api/v1/clipboard/{code} | Read content → returns {content, expires_at, views_remaining} |
| PUT | /api/v1/clipboard/{code} | Update content |
| DELETE | /api/v1/clipboard/{code} | Delete immediately |
| GET | /api/v1/words | Generate a random code |
curl -X POST https://ghostclip.dev/api/v1/clipboard \
-H "Authorization: Bearer gc_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"content":"Hello from the API","ttl_minutes":60}'
MCP Server — Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"ghostclip": {
"url": "https://ghostclip.dev/api/mcp",
"headers": { "Authorization": "Bearer gc_YOUR_KEY" }
}
}
}
MCP Server — Cursor / Cline
Add this to your MCP settings (.cursor/mcp.json or equivalent):
{
"mcpServers": {
"ghostclip": {
"url": "https://ghostclip.dev/api/mcp",
"headers": { "Authorization": "Bearer gc_YOUR_KEY" }
}
}
}
Available MCP tools
OpenAPI spec
Full machine-readable spec available at /openapi.json (OpenAPI 3.1). Use it for ChatGPT Custom Actions, Postman, or any OpenAPI-compatible tool.