# Basis Theory MCP by usefulapi

> Basis Theory MCP by usefulapi is a freemium MCP server for security. Hosted MCP server for read-only checks of a Basis Theory token vault. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/basis-theory/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/basis-theory
- **MCP Registry name:** io.usefulapi/basis-theory
- **Categories:** security, finance and payments
- **Listing updated:** 2026-11-14

## About

Card data stays in Basis Theory; this server only lets an assistant look at the metadata around it. It can search tokens by a metadata field such as a customer id and return each token's id, type, container and fingerprint, but never the stored value.

Beyond tokens, it reads audit-log entries filtered by entity type, the tenant usage report with token counts and monthly API call volume, tenant members and their roles, and the applications, proxies and reactors configured on the account.

You paste a read-only management key from the Basis Theory portal on the login page. Because every tool is a read, the server suits compliance reviews and access audits rather than changing the vault.

## Features

- **Token metadata search:** Find tokens by a metadata field such as a customer id and list their type, container and fingerprint.
- **Audit log review:** Read who changed which entity and when, narrowed by entity type.
- **Usage report:** See token counts by type and container plus monthly API call volume.
- **Access review:** List tenant members, roles, permissions and applications.
- **Proxy and reactor listing:** Inspect proxy destinations, transform settings and reactor configuration.

## Good for

- Check who changed the vault in the last week
- Locate every token tied to one customer
- Review who holds which role before an audit
- Report monthly API usage to finance

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http basis-theory https://basis-theory.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://basis-theory.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "basis-theory": {
      "url": "https://basis-theory.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "basis-theory": {
      "type": "http",
      "url": "https://basis-theory.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "basis-theory": {
      "serverUrl": "https://basis-theory.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "basis-theory": {
      "type": "http",
      "url": "https://basis-theory.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `basis_theory_list_tokens`: List vault tokens as METADATA — id, type, container, fingerprint, metadata and timestamps. Does not return the underlying card number or PII. Basis Theory: GET /v2/tokens.
- `basis_theory_search_tokens`: Search tokens with Basis Theory's query syntax over metadata, e.g. metadata.customer_id:"cus_1". Returns metadata only. Read-only despite being a POST — the query goes in the body. Basis Theory: POST /v2/tokens/search.
- `basis_theory_get_token`: Fetch a single token by id. Returns metadata, container, fingerprint and timestamps. WARNING: if the configured API key carries a reveal permission, the response also contains the token's plaintext data — issue this server a read-only management key instead. Basis Theory: GET /tokens/{id}.
- `basis_theory_list_applications`: List the applications (API-key holders) in the tenant, with their types and permissions. Basis Theory: GET /applications.
- `basis_theory_get_application`: Fetch a single application with its type and permission list. Basis Theory: GET /applications/{id}.
- `basis_theory_whoami`: Return the application the configured BT-API-KEY belongs to — the fastest way to check which permissions this server actually has. Basis Theory: GET /applications/key.
- `basis_theory_list_logs`: List audit-log entries — who did what to which entity and when. The tool for answering 'who touched this token?'. Basis Theory: GET /logs.
- `basis_theory_list_log_entity_types`: List the entity types the audit log records — the valid values for entity_type. Basis Theory: GET /logs/entity-types.
- `basis_theory_list_proxies`: List the proxies that forward requests to third parties, detokenizing in flight. Basis Theory: GET /proxies.
- `basis_theory_get_proxy`: Fetch a single proxy with its destination URL and transform configuration. Basis Theory: GET /proxies/{id}.
- `basis_theory_list_reactors`: List reactors — the serverless functions that run against detokenized data inside the vault. Basis Theory: GET /reactors.
- `basis_theory_get_reactor`: Fetch a single reactor with its configuration. Basis Theory: GET /reactors/{id}.
- `basis_theory_list_permissions`: List the permissions that can be granted to an application, optionally for one application type. Basis Theory: GET /permissions.
- `basis_theory_list_roles`: List the roles available for tenant members. Basis Theory: GET /roles.
- `basis_theory_get_tenant`: Fetch the current tenant — name, id and settings. Basis Theory: GET /tenants/self.
- `basis_theory_get_tenant_usage`: Fetch the tenant's usage report — token counts by type and container, and monthly API call volume. Basis Theory: GET /tenants/self/reports/usage.
- `basis_theory_list_tenant_members`: List the people with access to the tenant, and their roles. Basis Theory: GET /tenants/self/members.

## FAQ

### What does it cost to try?

The free plan gives 50 tool calls a month. Pro is $9 a month for 10,000 calls and Pro+ is $39 a month for 100,000, and each paid plan covers only the Basis Theory server.

### How do I sign in?

Add the server URL as a remote connector without any header. The login page then asks for your Basis Theory API key (create a read-only management key under Applications).

### Can it return card numbers?

No. The site says only metadata comes back, and the tools are all read-only.

### Is Basis Theory MCP by usefulapi free?

Basis Theory MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Basis Theory MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http basis-theory https://basis-theory.usefulapi.io/mcp

### What are the best alternatives to Basis Theory MCP by usefulapi?

The closest alternatives to Basis Theory MCP by usefulapi are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/basis-theory-mcp-by-usefulapi
