Skip to content
MCP server

Askell

Explore and call the Askell payments and subscriptions API from an MCP client

Runs locally
Install
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-mcp

Add 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 dashboardRequired
  • ASKELL_PUBLIC_API_KEYOptional public API key for temporary payment method and v1 checkout status endpoints
  • ASKELL_ENVproduction (default) or sandbox
  • ASKELL_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.

How AIPoweredBot checks servers