MCP server

Basis Theory MCP by usefulapi

io.usefulapi/basis-theory

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read token metadata, applications, audit logs, proxies and usage in the PCI vault.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

17

Token cost

About 2,265 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.basis-theory]
url = "https://basis-theory.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add basis-theory https://basis-theory.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"basis-theory","server_url":"https://basis-theory.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"basis-theory","server_url":"https://basis-theory.usefulapi.io/mcp"}

Tools

• basis_theory_get_application ~104 tokens
  Fetch a single application with its type and permission list. Basis Theory: GET /applications/{id}.
• basis_theory_get_proxy ~100 tokens
  Fetch a single proxy with its destination URL and transform configuration. Basis Theory: GET /proxies/{id}.
• basis_theory_get_reactor ~94 tokens
  Fetch a single reactor with its configuration. Basis Theory: GET /reactors/{id}.
• basis_theory_get_tenant ~69 tokens
  Fetch the current tenant — name, id and settings. Basis Theory: GET /tenants/self.
• basis_theory_get_tenant_usage ~88 tokens
  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_get_token ~152 tokens
  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 ~174 tokens
  List the applications (API-key holders) in the tenant, with their types and permissions. Basis Theory: GET /applications.
• basis_theory_list_log_entity_types ~82 tokens
  List the entity types the audit log records — the valid values for entity_type. Basis Theory: GET /logs/entity-types.
• basis_theory_list_logs ~238 tokens
  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_permissions ~113 tokens
  List the permissions that can be granted to an application, optionally for one application type. Basis Theory: GET /permissions.
• basis_theory_list_proxies ~154 tokens
  List the proxies that forward requests to third parties, detokenizing in flight. Basis Theory: GET /proxies.
• basis_theory_list_reactors ~158 tokens
  List reactors — the serverless functions that run against detokenized data inside the vault. Basis Theory: GET /reactors.
• basis_theory_list_roles ~65 tokens
  List the roles available for tenant members. Basis Theory: GET /roles.
• basis_theory_list_tenant_members ~136 tokens
  List the people with access to the tenant, and their roles. Basis Theory: GET /tenants/self/members.
• basis_theory_list_tokens ~243 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 ~203 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_whoami ~92 tokens
  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.

Browse

• Docker and Kubernetes
• Travel and flights

Related MCP servers

• Knack MCP by usefulapi
  Read, create, update and delete records; inspect objects, fields and schema in your Knack database.
• DeepInfra MCP by usefulapi
  Run DeepInfra inference, list models and read account rate limits.
• Nigerian Reference Data
  Nigerian phone, bank-account and identity-number validation for AI agents. Pay-per-call in USDC.
• seekrit — secrets for agents
  Encrypted store for API keys and database URLs your code needs. Use them without reading them.
• Arcadia Finance
  Concentrated liquidity on Uniswap/Aero (rebalance, compound, leverage) or single-sided lending.
• TeamUp MCP by usefulapi
  Check classes, attendance, customers, memberships and invoices in TeamUp and register customers.
• SendGrid MCP by usefulapi
  Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.
• VenuVidya — Carnatic Flute Study Guide
  Kannada/English Carnatic flute KSGMS syllabus — search lessons, log practice, ask a RAG guru.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/basis-theory.svg)](https://aptlynx.net/servers/io.usefulapi/basis-theory)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents