# Askell

> Askell is an MCP server for finance and payments. Explore and call the Askell payments and subscriptions API from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/neschadin/askell-mcp
- **MCP Registry name:** io.github.Neschadin/askell-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Paddle (Sandbox)](https://ai-powered.com/mcp/paddle-sandbox): Paddle (Sandbox) is a free MCP server for finance and payments.
- [Agent Data Tools: Full list (every tool as its own definition)](https://ai-powered.com/mcp/agent-data-tools-full-list-every-tool-as-its-own-definition): Agent Data Tools: Full list (every tool as its own definition) is a freemium MCP server for developer tools.
- [Paddle](https://ai-powered.com/mcp/paddle): Paddle is an MCP server for finance and payments.
- [Moltbound](https://ai-powered.com/mcp/moltbound): Moltbound is a free MCP server for finance and payments.
- [Assay A2A, MCP & x402 Pre-Flight Verifier & Observatory](https://ai-powered.com/mcp/assay-a2a-mcp-and-x402-pre-flight-verifier-and-observatory): Assay A2A, MCP & x402 Pre-Flight Verifier & Observatory is a freemium MCP server for security.
- [Stackapps Suite MCP](https://ai-powered.com/mcp/stackapps-suite-mcp): Stackapps Suite MCP is a paid MCP server for developer tools.
- [HeyAnon MCP](https://ai-powered.com/mcp/heyanon-mcp): HeyAnon MCP is an MCP server for finance and payments.
- [Synap](https://ai-powered.com/mcp/synap-2): Synap is a freemium MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/askell
