portaly-mcp

An npx-ready MCP server that connects MCP clients to a remote API service over stdio.

Install

npm install
npm run build

Run Locally

PORTALY_API_TOKEN=mcp_ptly_xxx \
npm run dev

After publishing, clients can run it with:

PORTALY_API_TOKEN=mcp_ptly_xxx \
npx portaly-mcp

You can also pass settings as flags:

npx @portaly-ai/portaly-mcp --base-url https://portaly.cc --token mcp_ptly_xxx

MCP Client Config

{
  "mcpServers": {
    "portaly": {
      "command": "npx",
      "args": ["-y", "@portaly-ai/portaly-mcp"],
      "env": {
        "PORTALY_API_TOKEN": "mcp_ptly_xxx"
      }
    }
  }
}

Tools

• listProducts: lists product summaries for the token's profile.
• getProduct: gets one product by product ID.
• createProduct: creates a digital product or live class.
• updateProduct: updates specific product fields by product ID.
• toggleProductStatus: flips or sets product active status.

Product responses include previewUrl when the authenticated profile has a public slug. The value is resolved to a full product page URL when returned by this MCP server; it is null when a preview URL cannot be built.

Product responses may also include imageUploadUrl. MCP cannot upload image files directly, so clients and agents should show this URL to the user as a clickable image upload link instead of sending image files, paths, or binary data through product creation or update tool inputs.

Configuration

| Name | Description | | --- | --- | | PORTALY_API_BASE_URL | Optional remote API base URL override. Defaults to https://portaly.cc. | | PORTALY_API_TOKEN | Optional bearer token or API token. |

The token is sent with the Authorization header as Bearer <token>. The request timeout defaults to 30000 milliseconds.