Basis Theory MCP by usefulapi
Hosted MCP server for read-only checks of a Basis Theory token vault
Answered our latest tool-list check 6 hours ago with 17 tools. It will be marked verified after 3 successful checks in 7 days.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://basis-theory.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"basis-theory": {
"url": "https://basis-theory.usefulapi.io/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments