Askell
Explore and call the Askell payments and subscriptions API from an MCP client
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- 4 days ago
Similar MCP servers
About Askell
Askell is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Rather than one tool per endpoint, it bundles the Askell OpenAPI operations and lets the model search them, read an operation's parameters and error codes, then call it. Reads and writes are separate tools, so a client can show its own approval prompt on mutations. A mutation gate can additionally force a confirmation form (elicit), follow the client's capabilities (auto) or be turned off for trusted automation.
The README recommends two server entries, one for production and one for sandbox, with keys kept in gitignored dotenv files. ASKELL_ENV selects the official host: askell.is/api for production or sandbox.askell.is/api for the isolated sandbox. A secret API key from the Askell dashboard is required; the public key is optional and only used by a few checkout endpoints.
It runs with Bun via bunx or from a prebuilt binary, and caps responses at 128 KB by default. Only hmac_secret is redacted in tool output.
Install
Run in a terminal
claude mcp add askell-mcp --env ASKELL_PRIVATE_API_KEY='<ASKELL_PRIVATE_API_KEY>' --env ASKELL_PUBLIC_API_KEY='<ASKELL_PUBLIC_API_KEY>' -- npx -y askell-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"askell-mcp": {
"command": "npx",
"args": [
"-y",
"askell-mcp"
],
"env": {
"ASKELL_PRIVATE_API_KEY": "<ASKELL_PRIVATE_API_KEY>",
"ASKELL_PUBLIC_API_KEY": "<ASKELL_PUBLIC_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"askell-mcp": {
"command": "npx",
"args": [
"-y",
"askell-mcp"
],
"env": {
"ASKELL_PRIVATE_API_KEY": "<ASKELL_PRIVATE_API_KEY>",
"ASKELL_PUBLIC_API_KEY": "<ASKELL_PUBLIC_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"askell-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"askell-mcp"
],
"env": {
"ASKELL_PRIVATE_API_KEY": "<ASKELL_PRIVATE_API_KEY>",
"ASKELL_PUBLIC_API_KEY": "<ASKELL_PUBLIC_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"askell-mcp": {
"command": "npx",
"args": [
"-y",
"askell-mcp"
],
"env": {
"ASKELL_PRIVATE_API_KEY": "<ASKELL_PRIVATE_API_KEY>",
"ASKELL_PUBLIC_API_KEY": "<ASKELL_PUBLIC_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"askell-mcp": {
"command": "npx",
"args": [
"-y",
"askell-mcp"
],
"env": {
"ASKELL_PRIVATE_API_KEY": "<ASKELL_PRIVATE_API_KEY>",
"ASKELL_PUBLIC_API_KEY": "<ASKELL_PUBLIC_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ASKELL_PRIVATE_API_KEYSecret API key from the Askell dashboardRequiredASKELL_PUBLIC_API_KEYOptional public API key for temporary payment method and v1 checkout status endpointsASKELL_ENVproduction (default) or sandboxASKELL_MUTATION_GATEMutation confirmation mode: auto (default), elicit, or off
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- askell_list_operations
- Search bundled OpenAPI operations.
- askell_describe_operation
- Parameters, body schema and error codes for one operation.
- askell_call
- GET or HEAD any v1 or v2 endpoint.
- askell_mutate
- POST, PUT, PATCH or DELETE any v1 or v2 endpoint.
- askell_paginate_all
- Follow paginated list endpoints.
- askell_customer_overview
- Customer with subscriptions and optional contracts.
- askell_contract_overview
- Subscription contract with billing runs.
- askell_billing_run_triage
- A billing run with an optional contract.
- askell_list_webhooks
- List webhooks with hmac_secret redacted.
What it does
- OpenAPI operation search
- Searches bundled v1 and v2 operations, their schemas and error codes.
- Separate read and mutate tools
- Lets clients gate writes with their own approval UI.
- Mutation gate
- Choose auto, elicit or off for confirmation behaviour.
- Production and sandbox
- Run two instances against different Askell environments.
- Billing triage helpers
- Overview tools for customers, contracts and billing runs.
- Response size cap
- Limits what is returned to the model, 131072 bytes by default.
Good for
- Inspect a customer's subscriptions and contracts
- Triage a failed billing run
- Look up which endpoint creates a subscription
- Test changes safely against the sandbox
Askell FAQ
What credentials are needed?
A secret API key from the Askell dashboard; the public key is optional.
Is there a sandbox?
Yes. Set ASKELL_ENV=sandbox for sandbox.askell.is/api, with keys from that dashboard.
Which runtime does it need?
Bun 1.4.4 or newer, or a prebuilt binary from the releases page.
How do I add Askell to Claude Code?
Run this command in your terminal: claude mcp add askell-mcp --env ASKELL_PRIVATE_API_KEY='<ASKELL_PRIVATE_API_KEY>' --env ASKELL_PUBLIC_API_KEY='<ASKELL_PUBLIC_API_KEY>' -- npx -y askell-mcp
What are the best alternatives to Askell?
The closest alternatives to Askell are Paddle (Sandbox), Agent Data Tools: Full list (every tool as its own definition), Paddle, Moltbound and Assay A2A, MCP & x402 Pre-Flight Verifier & Observatory.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
