Skip to content
MCP server

Basis Theory MCP by usefulapi

Hosted MCP server for read-only checks of a Basis Theory token vault

Status and history

Answered our latest tool-list check 6 hours ago with 17 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.40.0
Listing updated
3 days ago

About Basis Theory MCP by usefulapi

Basis Theory MCP by usefulapi is a freemium MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://basis-theory.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "basis-theory": {
      "url": "https://basis-theory.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (17)

Read directly from the server.

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.

What it does

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

Pricing

Freemium, from $9 a month

Free: 50 tool calls a month. Pro $9/mo (10,000 calls), Pro+ $39/mo (100,000 calls); yearly $90 and $390. Each paid plan covers this one server.

Prices change. Check usefulapi.io before you buy.

Basis Theory MCP by usefulapi 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 to Basis Theory MCP by usefulapi

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments