Basis Theory MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.39.2更新于 Nov 14, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行云端与基础设施金融安全与监控

概览

AI 生成的概览

以只读方式访问 Basis Theory PCI 保险库:令牌元数据、应用、审计日志、代理、反应器与租户用量。

可以做什么
  • 按元数据查询列出和搜索保险库令牌,并获取单个令牌的元数据
  • 查看应用及其类型与权限,并识别当前配置的密钥
  • 查阅审计日志及其记录的实体类型
  • 列出代理与反应器及其目标地址和转换配置
  • 读取租户信息、用量报告、成员与角色,以及可授予的权限
适用场景
适合让助手在不写代码的情况下回答关于 Basis Theory 保险库的问题:最近谁改动了什么、存了多少令牌、API 调用量多少,以及谁以何种角色拥有访问权限。
运行要求
远程 MCP 端点,仅需添加 URL,无需本地安装。通过 OAuth 登录,首次连接时需粘贴 Basis Theory 凭据,凭据经校验后按用户存储。不要在客户端配置中添加 Authorization 头或 API 密钥。
安装前请注意
若所配置的密钥带有 reveal 权限,获取令牌的工具可能返回明文令牌数据,建议使用只读管理密钥。凭据由第三方托管方存储。免费版每月 50 次工具调用;付费版通过 Stripe Checkout 计费,升级或取消订阅的工具会涉及付费或变更订阅。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Basis Theory MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fbasis-theory/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Basis Theory MCP by usefulapi

Read token metadata, applications, audit logs, proxies and usage in the PCI vault. Hosted, no local install.

Live endpoint: https://basis-theory.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://basis-theory.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http basis-theory https://basis-theory.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "basis-theory": {      "url": "https://basis-theory.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Basis Theory credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/basis-theory/

On first connect you'll paste your Basis Theory credentials. They are validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
basis_theory_list_tokensreadList tokens
basis_theory_search_tokensreadSearch tokens
basis_theory_get_tokenreadGet one token
basis_theory_list_applicationsreadList applications
basis_theory_get_applicationreadGet one application
basis_theory_whoamireadIdentify the configured key
basis_theory_list_logsreadList audit logs
basis_theory_list_log_entity_typesreadList log entity types
basis_theory_list_proxiesreadList proxies
basis_theory_get_proxyreadGet one proxy
basis_theory_list_reactorsreadList reactors
basis_theory_get_reactorreadGet one reactor
basis_theory_list_permissionsreadList permissions
basis_theory_list_rolesreadList roles
basis_theory_get_tenantreadGet the tenant
basis_theory_get_tenant_usagereadGet the tenant usage report
basis_theory_list_tenant_membersreadList tenant members
basis_theory_usage_statusmetaUsage status (free-tier meter)
basis_theory_request_featuremetaRequest a missing feature
basis_theory_upgrademetaUpgrade to Pro or Pro+
basis_theory_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run basis_theory_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with basis_theory_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with basis_theory_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

来源:servers/basis-theory/README.md,提交 3c1b3df

工具

17

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.

输入参数sizetypestartcontainerfingerprint

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.

输入参数sizequery必填start

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}.

输入参数token_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.

输入参数pagesizetype

basis_theory_get_application

Get one application

Fetch a single application with its type and permission list. Basis Theory: GET /applications/{id}.

输入参数application_id必填

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.

无需输入参数。

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.

输入参数pagesizeend_dateentity_idstart_dateentity_type

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.

无需输入参数。

basis_theory_list_proxies

List proxies

List the proxies that forward requests to third parties, detokenizing in flight. Basis Theory: GET /proxies.

输入参数namepagesize

basis_theory_get_proxy

Get one proxy

Fetch a single proxy with its destination URL and transform configuration. Basis Theory: GET /proxies/{id}.

输入参数proxy_id必填

basis_theory_list_reactors

List reactors

List reactors — the serverless functions that run against detokenized data inside the vault. Basis Theory: GET /reactors.

输入参数namepagesize

basis_theory_get_reactor

Get one reactor

Fetch a single reactor with its configuration. Basis Theory: GET /reactors/{id}.

输入参数reactor_id必填

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.

输入参数application_type

basis_theory_list_roles

List roles

List the roles available for tenant members. Basis Theory: GET /roles.

无需输入参数。

basis_theory_get_tenant

Get the tenant

Fetch the current tenant — name, id and settings. Basis Theory: GET /tenants/self.

无需输入参数。

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.

无需输入参数。

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.

输入参数pagesize

版本历史

26
  1. v1.39.2最新Nov 14, 2026
  2. v1.39.1Nov 13, 2026
  3. v1.38.0Nov 12, 2026
  4. v1.37.3Nov 11, 2026
  5. v1.36.5Nov 8, 2026
  6. v1.36.4Nov 7, 2026
  7. v1.35.3Nov 5, 2026
  8. v1.35.2Nov 5, 2026
  9. v1.35.1Nov 4, 2026
  10. v1.35.0Nov 3, 2026
  11. v1.34.1Nov 3, 2026
  12. v1.33.0Nov 1, 2026
  13. v1.31.0Oct 31, 2026
  14. v1.30.0Oct 31, 2026
  15. v1.29.2Oct 30, 2026
  16. v1.29.0Oct 30, 2026
  17. v1.24.0Oct 26, 2026
  18. v1.21.3Oct 25, 2026
  19. v1.21.0Oct 25, 2026
  20. v1.20.0Oct 24, 2026
  21. v1.17.0Oct 23, 2026
  22. v1.16.4Oct 22, 2026
  23. v1.16.3Oct 21, 2026
  24. v1.11.1Oct 9, 2026
  25. v1.10.0Oct 9, 2026
  26. v1.0.0Sep 29, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成