thorbit-account-mcp

MCP server for Thorbit account administration — credits (balance, ledger history), files/artifacts (list, read, versions, share links), AI chat history (list, read conversations), projects (list, create, delete, restore), billing plan info, and org membership (list, invite, remove, update role). All tools are synchronous — this server has no async/pollable run concept, unlike thorbit-icp-mcp or thorbit-topic-map-mcp; every call reads or writes data Phoenix (or Clerk, for org membership) already has and returns the result directly, with no start/poll/get_result loop. This package is a thin stdio client that forwards every tool call to the hosted Thorbit route and is authenticated against your Thorbit MCP API key.

Install / run

npx thorbit-account-mcp

Or add it to an MCP client config:

{
  "mcpServers": {
    "thorbit-account": {
      "command": "npx",
      "args": ["thorbit-account-mcp"],
      "env": {
        "THORBIT_ACCOUNT_MCP_API_KEY": "thbt_mcp_..."
      }
    }
  }
}

Generate the same JSON from the CLI:

npx -y -p thorbit-account-mcp@latest thorbit-account-mcp-install --json --api-key thbt_mcp_...

Prefer a key file on shared machines and servers:

mkdir -p ~/.config/thorbit
printf '%s\n' 'thbt_mcp_...' > ~/.config/thorbit/account-mcp-key
chmod 600 ~/.config/thorbit/account-mcp-key
npx -y -p thorbit-account-mcp@latest thorbit-account-mcp-install --key-path ~/.config/thorbit/account-mcp-key

Run npx -y -p thorbit-account-mcp@latest thorbit-account-mcp-install --help for all options.

Environment

• THORBIT_ACCOUNT_MCP_API_KEY — your Thorbit MCP API key (required). Fallbacks: THORBIT_API_KEY, THORBIT_MCP_API_KEY, or a key file at ~/.thorbit-account-mcp-key (override path with THORBIT_ACCOUNT_MCP_KEY_PATH).
• THORBIT_ACCOUNT_MCP_BASE_URL — optional, defaults to https://thorbit.ai. Fallback: THORBIT_BASE_URL.

The key is never logged.

Tools

17 tools across 6 domains, all synchronous — no start/poll/get_result cycle for any of them:

1. thorbit_account_credits_get_balance — current credit balance.
2. thorbit_account_credits_list_ledger — credit ledger / usage history.
3. thorbit_account_files_list — list files/artifacts.
4. thorbit_account_files_get — read one file/artifact.
5. thorbit_account_files_get_version — read one artifact version's content.
6. thorbit_account_files_create_share_link — create (or return the existing) share link for an artifact.
7. thorbit_account_chats_list — list AI chat conversations.
8. thorbit_account_chats_get — read one conversation's messages.
9. thorbit_account_projects_list — list projects.
10. thorbit_account_projects_create — create a project.
11. thorbit_account_projects_delete — soft-delete (trash) a project.
12. thorbit_account_projects_restore — restore a trashed project.
13. thorbit_account_billing_get_plan — current billing plan/subscription info.
14. thorbit_account_org_list_members — list org members.
15. thorbit_account_org_invite_member — invite an org member.
16. thorbit_account_org_remove_member — remove an org member.
17. thorbit_account_org_update_member_role — update an org member's role.

Develop

npm install
npm run typecheck
npm run test
npm run build