Subtotal Model Context Protocol

The Subtotal Model Context Protocol server allows you to integrate with Subtotal APIs through function calling.

Setup

To run the Subtotal MCP server using npx, use the following command:

``bash


To set up all available tools

npx -y @subtotal-inc/mcp --tools=all --subtotal-secret-key=

To set up specific tools

npx -y @subtotal-inc/mcp --tools=get-purchases,get-purchase-details --subtotal-secret-key=
`

Make sure to replace with your actual Subtotal API secret API key value.
Alternatively, you could set the SUBTOTAL_SECRET_KEY environment variable.

$3

Add the following to your claude_desktop_config.json. See here for more details.

`
{
“mcpServers”: {
“subtotal”: {
“command”: “npx”,
“args”: [
“-y”,
“@subtotal-inc/mcp”,
“--tools=all”,
“--subtotal-secret-key=”
]
}
}
}
`

Available tools

| Tool | Description |
| -------------------------- | ------------------------------ |
| get-merchants | Get merchants |
| create-connection | Create a new connection |
| create-merchant-link-url | Create a new merchant link URL |
| get-purchases | Get purchases |
| get-purchase-details | Get purchase details |

Debugging the Server

To debug your server, you can use the MCP Inspector.

First build the server

`
npm run build
`

Run the following command in your terminal:

`bash


Start MCP Inspector and server with all tools


npx @modelcontextprotocol/inspector node dist/index.js --tools=all --subtotal-secret-key=
`

$3

1. Replace ` with your actual Subtotal API secret key value.
2. Run the command to start the MCP Inspector.
3. Open the MCP Inspector UI in your browser and click Connect to start the MCP server.
4. You can see the list of tools you selected and test each tool individually.