pastebin-mcp
MCP server for the homelab pastebin service. Exposes create, read, list, and delete
operations as MCP tools so agents can interact with pastebin programmatically.
Tools
| Tool |
Auth required |
Description |
create_paste |
No |
Create a paste; returns URL and ID |
get_paste |
No |
Fetch full paste metadata + content |
get_raw |
No |
Fetch raw paste text only |
list_pastes |
Yes (API key) |
List recent pastes with pagination |
delete_paste |
Yes (API key) |
Permanently delete a paste |
Environment variables
| Variable |
Default |
Description |
PASTEBIN_URL |
http://192.168.0.242:3002 |
Pastebin service base URL |
PASTEBIN_API_KEY |
(empty) |
API key for privileged operations |
PASTEBIN_MCP_TRANSPORT |
stdio |
Transport: stdio, sse, or streamable-http |
FASTMCP_HOST |
127.0.0.1 |
Bind host for HTTP transports |
FASTMCP_PORT |
8000 |
Bind port for HTTP transports |
FASTMCP_STREAMABLE_HTTP_PATH |
/mcp |
HTTP path for streamable-http transport |
Install
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Run (HTTP / MCP endpoint)
PASTEBIN_MCP_TRANSPORT=streamable-http \
FASTMCP_HOST=0.0.0.0 \
FASTMCP_PORT=8004 \
PASTEBIN_API_KEY=<key> \
python mcp_server.py
Run (stdio for Claude Desktop / claude mcp add)
PASTEBIN_API_KEY=<key> pastebin-mcp
Register globally (HTTP)
claude mcp add --transport http --scope user pastebin-mcp http://192.168.0.242:8004/mcp
