create_client_side_token

Generate client-side tokens to authenticate Paddle.js integrations for specific applications or environments, enabling secure payment processing.

Instructions

This tool will create a new client-side token in Paddle.

Client-side tokens are needed to authenticate with Paddle.js. A token is provided when initializing Paddle.js.

When creating a client-side token, provide a descriptive name to help identify its purpose. Usually created for each application or environment that needs to authenticate with Paddle.js.

If successful, the response includes a copy of the new client-side token entity. The returned token field is the client-side token that needs to be provided when initializing Paddle.js. Can be exposed client-side safely. If it starts with:

test_: The token is a test token for a sandbox environment and shouldn't be used in production.
live_: The token is a live token for a production environment. It can be used to test too but Paddle.js checkouts require real cards.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`name`	Yes	Name of this client-side token.
`description`	No	Short description for this client-side token.

Implementation Reference

src/functions.ts:982-989 (handler)

The handler function that implements the core logic of the 'create_client_side_token' tool by calling paddle.clientTokens.create(params) and handling errors.

export const createClientSideToken = async (paddle: Paddle, params: z.infer<typeof Parameters.createClientSideTokenParameters>) => {
  try {
    const clientSideToken = await paddle.clientTokens.create(params);
    return clientSideToken;
  } catch (error) {
    return error;
  }
};

src/tools.ts:985-996 (schema)

Tool schema definition including the method name, human-readable name, description prompt, Zod parameters schema reference, and required actions for permissions.

{
  method: "create_client_side_token",
  name: "Create a client-side token",
  description: prompts.createClientSideTokenPrompt,
  parameters: params.createClientSideTokenParameters,
  actions: {
    clientSideTokens: {
      write: true,
      create: true,
    },
  },
},

src/api.ts:90-90 (registration)
Registers the createClientSideToken handler function to the tool method constant in the toolMap used by PaddleAPI to dispatch tool calls.
```
[TOOL_METHODS.CREATE_CLIENT_SIDE_TOKEN]: funcs.createClientSideToken,
```
src/constants.ts:82-82 (helper)
Constant defining the string identifier for the 'create_client_side_token' tool method.
```
CREATE_CLIENT_SIDE_TOKEN: "create_client_side_token",
```

Paddle MCP Server