# Pagio MCP

A local [MCP](https://modelcontextprotocol.io) server for [Pagio Store](https://pagio.store). It lets Cursor, Claude, and other MCP apps create and update your store and products from a prompt.

The server runs on your computer. It sends your API key to `https://pagio.store` over HTTPS. The key is not written into this repository.

## Enable it

1. Open [Settings](https://pagio.store/dashboard/settings) and choose **Enable and create a key**.
2. Copy the API key. It is shown once. Rotate the key if you need another copy.
3. Copy the installation snippet and paste it into your MCP client.

Turning prompt setup off stops the key immediately. Turning it back on uses the same key.

## Install

Cursor reads `~/.cursor/mcp.json`. Claude Desktop reads `claude_desktop_config.json`. Both use the same shape:

```json
{
  "mcpServers": {
    "pagio": {
      "command": "npx",
      "args": ["-y", "github:oivoodoo/pagio-mcp"],
      "env": {
        "PAGIO_API_KEY": "pgio_PASTE_YOUR_KEY",
        "PAGIO_API_URL": "https://pagio.store"
      }
    }
  }
}
```

On Windows, set `command` to `cmd` and `args` to `["/c", "npx", "-y", "github:oivoodoo/pagio-mcp"]`.

`PAGIO_API_URL` defaults to `https://pagio.store`. Use `http://127.0.0.1` only when you are running Pagio yourself.

## Tools

| Tool | What it does |
| --- | --- |
| `get_store` | Read the store. Creates the profile if you have not opened the store page yet. |
| `update_store` | Change the name, handle, bio, theme, social links, or published flag. |
| `list_products` | List products, including drafts. |
| `get_product` | Read one product, including whether a PDF is uploaded. |
| `create_product` | Create a paid PDF, free PDF, booking, or link. |
| `update_product` | Change one product. |
| `publish_product` | Publish one product. |
| `unpublish_product` | Return one product to draft. |

A booking or a link can be published when it has an `https` URL. A paid or free PDF can be drafted from the prompt, and published after you upload the file on the Products page. A paid PDF, booking, or link also needs an `https` URL before it can be published.

Pagio stores the display price and the checkout link. It does not charge that price and it does not confirm the payment.

## Key care

Treat the API key like a password. Do not commit it. Pagio stores only a hash. Disable prompt setup in Settings to stop a key, or rotate it to replace the hash. A disabled account rejects the key even when the key itself is valid.

## Development

```sh
npm test
```

Requires Node.js 20 or newer.

## License

MIT