MCP-Server

basis-theory

io.usefulapi/basis-theory
Payments & Fintech Sicherheit Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Reads metadata and audit information for tokenized payment or sensitive data in a Basis Theory vault, including applications, proxies, reactors and usage.

basis_theory_get_application
Get one application
Fetch a single application with its type and permission list. Basis Theory: GET /applications/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['application_id'], 'properties': {'application_id': {'type': 'string', 'description': "The application's id."}}}
basis_theory_get_proxy
Get one proxy
Fetch a single proxy with its destination URL and transform configuration. Basis Theory: GET /proxies/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['proxy_id'], 'properties': {'proxy_id': {'type': 'string', 'description': "The proxy's id."}}}
basis_theory_get_reactor
Get one reactor
Fetch a single reactor with its configuration. Basis Theory: GET /reactors/{id}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['reactor_id'], 'properties': {'reactor_id': {'type': 'string', 'description': "The reactor's id."}}}
basis_theory_get_tenant
Get the tenant
Fetch the current tenant — name, id and settings. Basis Theory: GET /tenants/self.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
basis_theory_get_tenant_usage
Get the tenant usage report
Fetch the tenant's usage report — token counts by type and container, and monthly API call volume. Basis Theory: GET /tenants/self/reports/usage.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
basis_theory_get_token
Get one 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}.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token_id'], 'properties': {'token_id': {'type': 'string', 'description': "The token's id."}}}
basis_theory_list_applications
List applications
List the applications (API-key holders) in the tenant, with their types and permissions. Basis Theory: GET /applications.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (offset pagination).'}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'type': {'type': 'string', 'description': 'Only applications of this type, e.g. private, public, management, expiring.'}}}
basis_theory_list_log_entity_types
List log entity types
List the entity types the audit log records — the valid values for entity_type. Basis Theory: GET /logs/entity-types.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
basis_theory_list_logs
List audit 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.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (offset pagination).'}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'end_date': {'type': 'string', 'description': 'ISO-8601 upper bound.'}, 'entity_id': {'type': 'string', 'description': 'Only entries for this entity id.'}, 'start_date': {'type': 'string', 'description': 'ISO-8601 lower bound.'}, 'entity_type': {'type': 'string', 'description': 'Only entries for this entity type, e.g. token, application, proxy.'}}}
basis_theory_list_permissions
List permissions
List the permissions that can be granted to an application, optionally for one application type. Basis Theory: GET /permissions.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'application_type': {'type': 'string', 'description': 'Only permissions valid for this application type.'}}}
basis_theory_list_proxies
List proxies
List the proxies that forward requests to third parties, detokenizing in flight. Basis Theory: GET /proxies.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'name': {'type': 'string', 'description': 'Filter by proxy name.'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (offset pagination).'}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}}}
basis_theory_list_reactors
List reactors
List reactors — the serverless functions that run against detokenized data inside the vault. Basis Theory: GET /reactors.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'name': {'type': 'string', 'description': 'Filter by reactor name.'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (offset pagination).'}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}}}
basis_theory_list_roles
List roles
List the roles available for tenant members. Basis Theory: GET /roles.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
basis_theory_list_tenant_members
List tenant members
List the people with access to the tenant, and their roles. Basis Theory: GET /tenants/self/members.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (offset pagination).'}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}}}
basis_theory_list_tokens
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.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'type': {'type': 'string', 'description': 'Only tokens of this type, e.g. card, bank, token.'}, 'start': {'type': 'string', 'description': "Cursor from the previous page's pagination.next. Omit for the first page."}, 'container': {'type': 'string', 'description': 'Only tokens in this container path, e.g. /pci/high/.'}, 'fingerprint': {'type': 'string', 'description': 'Only tokens sharing this fingerprint — how you find duplicates of the same card.'}}}
basis_theory_search_tokens
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.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Page size, 1-100.'}, 'query': {'type': 'string', 'description': 'Query string, e.g. type:card AND metadata.customer_id:"cus_1".'}, 'start': {'type': 'string', 'description': "Cursor from the previous page's pagination.next. Omit for the first page."}}}
basis_theory_whoami
Identify the configured key
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.
Nur Lesen
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Geändert
basis_theory_list_tenant_members
2. October 2026 02:40
Geändert
basis_theory_get_tenant_usage
2. October 2026 02:40
Geändert
basis_theory_get_tenant
2. October 2026 02:40
Geändert
basis_theory_list_roles
2. October 2026 02:40
Geändert
basis_theory_list_permissions
2. October 2026 02:40
Geändert
basis_theory_get_reactor
2. October 2026 02:40
Geändert
basis_theory_list_reactors
2. October 2026 02:40
Geändert
basis_theory_get_proxy
2. October 2026 02:40
Geändert
basis_theory_list_proxies
2. October 2026 02:40
Geändert
basis_theory_list_log_entity_types
2. October 2026 02:40
Geändert
basis_theory_list_logs
2. October 2026 02:40
Geändert
basis_theory_whoami
2. October 2026 02:40
Geändert
basis_theory_get_application
2. October 2026 02:40
Geändert
basis_theory_list_applications
2. October 2026 02:40
Geändert
basis_theory_get_token
2. October 2026 02:40
Geändert
basis_theory_search_tokens
2. October 2026 02:40
Geändert
basis_theory_list_tokens
2. October 2026 02:40
Hinzugefügt
basis_theory_list_tenant_members
30. September 2026 02:40
Hinzugefügt
basis_theory_get_tenant_usage
30. September 2026 02:40
Hinzugefügt
basis_theory_get_tenant
30. September 2026 02:40
Hinzugefügt
basis_theory_list_roles
30. September 2026 02:40
Hinzugefügt
basis_theory_list_permissions
30. September 2026 02:40
Hinzugefügt
basis_theory_get_reactor
30. September 2026 02:40
Hinzugefügt
basis_theory_list_reactors
30. September 2026 02:40
Hinzugefügt
basis_theory_get_proxy
30. September 2026 02:40
Hinzugefügt
basis_theory_list_proxies
30. September 2026 02:40
Hinzugefügt
basis_theory_list_log_entity_types
30. September 2026 02:40
Hinzugefügt
basis_theory_list_logs
30. September 2026 02:40
Hinzugefügt
basis_theory_whoami
30. September 2026 02:40
Hinzugefügt
basis_theory_get_application
30. September 2026 02:40