1px MCP

Model Context Protocol server for 1px — a minimalist utility suite for the web.

What it does

This MCP server lets AI assistants (Claude, Cursor, etc.) interact with your 1px account:

• Shorten URLs — create_short_url
• Create pastes — create_paste
• Host markdown — create_markdown
• Upload files — upload_file
• List items — list_items
• Update pastes/markdowns — update_paste, update_markdown
• Delete items — delete_item

Setup

1. Get an API key

Go to https://1px.ch/dashboard/api and create an API key.

2. Install

npx @1px-labs/1px-mcp

Or clone and run locally:

git clone https://github.com/1px-labs/1px.git
cd 1px/1px-mcp
npm install
npm start

3. Configure with Claude Desktop

Open your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the 1px server:

{
  "mcpServers": {
    "1px": {
      "command": "node",
      "args": ["/absolute/path/to/1px-mcp/src/index.js"],
      "env": {
        "ONE_PX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or use the published npm package:

{
  "mcpServers": {
    "1px": {
      "command": "npx",
      "args": ["@1px-labs/1px-mcp"],
      "env": {
        "ONE_PX_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Restart Claude Desktop

Quit and reopen Claude. The 1px tools will appear in the MCP tools panel.

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | ONE_PX_API_KEY | (required) | Your 1px API key | | ONE_PX_API_BASE | https://api.1px.ch | API base URL (override for self-hosted) |

Example prompts

"Shorten this link for me: https://example.com/very/long/path"

"Save this error log to 1px so I can share it"

"Create a markdown page with my meeting notes"

"What files have I uploaded recently?"

"Delete that paste abc123"

Development

npm install
ONE_PX_API_KEY=your_key node src/index.js

The server runs over stdio (standard input/output) as required by the MCP protocol. It does not expose an HTTP server.