Skip to content

Connectors · Accounting & finance

Smokeball MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Smokeball and the rest of your systems. It gives your agent 195 Smokeball actions (91 reads, 76 writes and 28 that wait for a confirmation) and holds the Smokeball credential itself, so the agent never does. It paces Smokeball's limits and records every call.

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp
the first call
do {  action: "smokeball.tasks.list",  intent: "check which Smokeball account is connected"}# Get tasks · read · 1 upstream call
  • 195actionsin one signed file
  • 91readlook, never change
  • 76writecreate and update
  • 28wait for a yesdestructive, confirmed first

Set up

Connect Smokeball in three steps.

  1. 01

    Add actionlake to Claude.

    Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.

    https://connect.actionlake.com/mcp
  2. 02

    Connect Smokeball.

    OAuth 2.0, client credentials. Paste the app's client id and secret; actionlake fetches and renews the token, and nobody has to sign in. actionlake stores what you paste write-only, sealed under your tenant's key.

    • client_idOAuth client id of your Smokeball app (Developer Console > App Details)
    • client_secretOAuth client secret of the same Smokeball app (Developer Console > App Details)
    • api_keySmokeball-issued API key, sent as the x-api-key header on every request
    • api_hostWhere your Smokeball lives: your api host
    account { op: "connections.requirements", service: "smokeball" }
    # free: exactly what to paste, and what is found for you
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

    do    { action: "smokeball.tasks.list" }# get tasks · read · 1 upstream callcheck { action: "smokeball.tasks.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

Smokeball at a glance

Sign-in
OAuth 2.0, client credentials. Paste the app's client id and secret; actionlake fetches and renews the token, and nobody has to sign in.
You provide
client_idclient_secretapi_key
Setup fields
api_host
Limits we pace to
5 calls a second, per connection
API covered
Smokeball API (1.0; OpenAPI 3.0)api.smokeball.com
Built from
Smokeball's documentation, read 23 October 2026docs.smokeball.comdocs.smokeball.com
Service file
Version 1.0.0, signed (Ed25519)
Cached reads
91 of 91 reads, for up to 5 minutes; a write clears what it affects
Shared entities
6, so ask can line Smokeball up with your other systems
Data
Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in Smokeball.

195 actions in 51 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

  • 91readlook, never change
  • 76writecreate and update
  • 28destructivewait for a confirmation
  1. Matter files

    13

    7 read · 5 write · 1 destructive

    Get files on a matter · Get a file · Delete a file · Upload/update version or metadata of a file

  2. Matter folders

    8

    4 read · 3 write · 1 destructive

    Create a folder · Update a folder · Delete a folder · Get folder history on a matter

  3. Bank accounts

    7

    4 read · 3 write · 0 destructive

    Get bank accounts · Get a bank account · Create a requisition · Get bank account matter balances

  4. Contacts

    6

    3 read · 2 write · 1 destructive

    Get contacts · Create a contact · Get a contact · Update a contact

  5. Invitations

    6

    2 read · 3 write · 1 destructive

    Invite a person to join the firm · Search invitations · Accept an invitation · Get an invitation

  6. Matter expenses

    6

    2 read · 3 write · 1 destructive

    Get expenses · Create an expense · Get an expense · Update an expense

  7. Matter fees

    6

    2 read · 3 write · 1 destructive

    Get fees · Create a fee · Update a fee · Get a fee

  8. Matters

    6

    2 read · 3 write · 1 destructive

    Get matters · Create a matter · Get a matter · Update a matter

43 more areas · 137 actions
  • Plugins 6
  • Webhooks 6
  • Activity codes 5
  • Contact relations 5
  • Events 5
  • Groups 5
  • Matter layouts 5
  • Matter memos 5
  • Matter role relationships 5
  • Matter roles 5
  • Staff 5
  • Task subtasks 5
  • Tasks 5
  • Event reminders 4
  • Firm users 4
  • Plugin subscriptions 4
  • Task documents 4
  • Users 4
  • Bank account transactions 3
  • Contact tags 3
  • Firm 3
  • Matter archive 3
  • Matter billing configuration 3
  • Matter invoices 3
  • Matter layout contacts 3
  • Matter tags 3
  • Policies 3
  • Layouts 2
  • Matter items 2
  • Matter portal tasks 2
  • Matter types 2
  • Notifications 2
  • Referral types 2
  • Stage sets 2
  • Files 1
  • Matter integrated search mapping 1
  • Matter portal messages 1
  • Matter stage mappings 1
  • Matter stages 1
  • Matter type categories 1
  • Stage set stages 1
  • User registrations 1
  • Webhook event types 1

Top actions

The Smokeball API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 54 of Smokeball's 54 action names are shared with at least one other connector, so an agent learns them once.

ActionWhat it doesEffectSame name in
smokeball.tasks.listGet tasksGet tasks.readwork.task.list122 connectors
smokeball.matters.listGet mattersGet matters.readwork.project.list109 connectors
smokeball.staff.listSearch firm staff membersSearch firm staff members.readidentity.user.list474 connectors
smokeball.tasks.createCreate a taskCreate a task.writework.task.create127 connectors
smokeball.matters.createCreate a matterCreate a matter.writework.project.create102 connectors
smokeball.contacts.listGet contactsGet contacts.readcrm.contact.list177 connectors
smokeball.bank_accounts.listGet bank accountsGet bank accounts.readfinance.bank_account.list35 connectors
smokeball.tasks.deleteDelete a taskDelete a task.destructivework.task.delete107 connectors
smokeball.events.listGet eventsGet events.readcomm.event.list61 connectors
smokeball.staff.createCreate firm staff memberCreate firm staff member.writeidentity.user.create262 connectors
smokeball.contacts.createCreate a contactCreate a contact.writecrm.contact.create161 connectors
smokeball.matter_fees.createCreate a feeCreate a fee.writework.time_entry.create56 connectors

Try it

Prompts to paste into Claude.

Each one names the Smokeball actions it will call, so you know what it reads and what it changes before you send it.

  1. Readread

    Which Smokeball tasks are overdue, and who owns each one?

    callssmokeball.tasks.list

  2. Writewrite

    Create a task in Smokeball. Show me exactly what you will send before you save it.

    callssmokeball.tasks.create

  3. Across systemsread

    Which contacts are in both Smokeball and HaloPSA, and how many are in only one of them?

    callssmokeball.contacts.listhalopsa.users.list

Across your systems

Smokeball, joined to the rest of your business.

One ask fetches from Smokeball and another system, joins the rows on the same customer on our side, and hands your agent the answer, not every row.

  • Which contacts are in both Smokeball and HaloPSA, and how many are in only one of them?

    smokeball.contacts.list + halopsa.users.list, on crm.contact · HaloPSA

  • Which contacts are in both Smokeball and HubSpot CRM, and how many are in only one of them?

    smokeball.contacts.list + hubspot_crm.contacts.list, on crm.contact · HubSpot CRM

Also mapped by other connectorsidentity.user 517crm.contact 192work.project 116work.task 105comm.event 47finance.bank_account 25
ask
ask {  intent: "which contacts are in both Smokeball and HaloPSA, and how many are in only one of them",  steps: [    { action: "smokeball.contacts.list", as: "people", input: {}, limit: 100, max_pages: 5 },    { action: "halopsa.users.list", as: "people2", input: {}, limit: 100, max_pages: 5 },    { join: {        left: "people",        right: "people2",        on: "crm.contact",        group_by: "people.email",        select: ["people.email", "count(people2.id) as in_halopsa"]    } }  ]}
Example. Run it through check first: it validates the steps and prices them, and it is free.

Governance for Smokeball

Destructive actions wait for a yes.

28 Smokeball actions are destructive. These are all of them:

  • Delete a tasksmokeball.tasks.delete
  • Delete a mattersmokeball.matters.delete
  • Deletes a firm staff membersmokeball.staff.delete
  • Delete a contactsmokeball.contacts.delete
  • Delete a feesmokeball.matter_fees.delete
  • Delete eventsmokeball.events.delete
  • Deletes an authorization groupsmokeball.groups.delete
  • Delete an expensesmokeball.matter_expenses.delete
  • Delete a filesmokeball.matter_files.delete
  • Delete a foldersmokeball.matter_folders.delete
  • Remove a usersmokeball.users.delete
  • Delete existing pluginsmokeball.plugins.delete
  • Deletes a webhook subscriptionsmokeball.webhooks.delete
  • Delete firm user mappingsmokeball.firm_users.delete
  • Remove tags from a mattersmokeball.matter_tags.delete
  • Remove tags from a contactsmokeball.contact_tags.delete
  • Delete a memosmokeball.matter_memos.delete
  • Remove role from a mattersmokeball.matter_roles.delete
  • Delete a subtasksmokeball.task_subtasks.delete
  • Delete an activity codesmokeball.activity_codes.delete
  • Remove a layoutsmokeball.matter_layouts.delete
  • Delete a task documentsmokeball.task_documents.delete
  • Delete reminder for an eventsmokeball.event_reminders.delete
  • Delete a contact relationsmokeball.contact_relations.delete
  • Unsubscribes account from pluginsmokeball.plugin_subscriptions.delete
  • Remove a contact from a layoutsmokeball.matter_layout_contacts.delete
  • Remove relationship from a role in a matter.smokeball.matter_role_relationships.delete
  • Cancel an invitationsmokeball.invitations.cancel

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

dosmokeball.tasks.deleteconfirm_policy: human

Delete a task?

intent: the user asked me to delete a task

run suspended · waiting for a named person · key smokeball-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
account {  op: "keys.create", name: "smokeball-agent",  allowed_actions: ["smokeball.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "smokeball.tasks.delete", approver: "[email protected]" },    { match: "smokeball.matters.delete", approver: "[email protected]" },    { match: "smokeball.staff.delete", approver: "[email protected]" }  ]}
Illustrative. Scoped to Smokeball only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What Smokeball costs on actionlake.

Every Smokeball action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Smokeball refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

  • 1upstream call per actionall 195 Smokeball actions
  • 195actions pageeach page of a long list is one call
  • 91reads can be cacheda cache hit costs nothing
  • 100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Smokeball action.

195 actions by area: the id your agent calls, what it does, and its effect.

Matter files13
  • smokeball.matter_files.bulk_createAdd files to a matterwrite
  • smokeball.matter_files.createAdd file to a matterwrite
  • smokeball.matter_files.create_previewGet or create a previewwrite
  • smokeball.matter_files.deleteDelete a filedestructive
  • smokeball.matter_files.getGet a fileread
  • smokeball.matter_files.get_download_urlGet download url for a fileread
  • smokeball.matter_files.get_previewGet preview info for a fileread
  • smokeball.matter_files.get_preview_versionGet preview info for a file by document versionread
  • smokeball.matter_files.get_upload_urlGet upload url for a fileread
  • smokeball.matter_files.historyGet file history on a matterread
  • smokeball.matter_files.listGet files on a matterread
  • smokeball.matter_files.patchPatch a filewrite
  • smokeball.matter_files.updateUpload/update version or metadata of a filewrite
Matter folders8
  • smokeball.matter_folders.createCreate a folderwrite
  • smokeball.matter_folders.deleteDelete a folderdestructive
  • smokeball.matter_folders.historyGet folder history on a matterread
  • smokeball.matter_folders.list_contentsGet folders/files under a folderread
  • smokeball.matter_folders.list_rootGet folders/files under root folderread
  • smokeball.matter_folders.patchPatch a folderwrite
  • smokeball.matter_folders.pathGet folder path hierarchyread
  • smokeball.matter_folders.updateUpdate a folderwrite
Bank accounts7
  • smokeball.bank_accounts.create_requisitionCreate a requisitionwrite
  • smokeball.bank_accounts.getGet a bank accountread
  • smokeball.bank_accounts.get_protected_balanceGet a protected bank account balanceread
  • smokeball.bank_accounts.listGet bank accountsread
  • smokeball.bank_accounts.matter_balancesGet bank account matter balancesread
  • smokeball.bank_accounts.protect_fundsProtect bank account fundswrite
  • smokeball.bank_accounts.unprotect_fundsUnprotect bank account fundswrite
Contacts6
  • smokeball.contacts.batch_getGet contacts by idsread
  • smokeball.contacts.createCreate a contactwrite
  • smokeball.contacts.deleteDelete a contactdestructive
  • smokeball.contacts.getGet a contactread
  • smokeball.contacts.listGet contactsread
  • smokeball.contacts.updateUpdate a contactwrite
Invitations6
  • smokeball.invitations.acceptAccept an invitationwrite
  • smokeball.invitations.cancelCancel an invitationdestructive
  • smokeball.invitations.createInvite a person to join the firmwrite
  • smokeball.invitations.getGet an invitationread
  • smokeball.invitations.listSearch invitationsread
  • smokeball.invitations.resendResend an invitationwrite
Matter expenses6
  • smokeball.matter_expenses.createCreate an expensewrite
  • smokeball.matter_expenses.deleteDelete an expensedestructive
  • smokeball.matter_expenses.getGet an expenseread
  • smokeball.matter_expenses.listGet expensesread
  • smokeball.matter_expenses.patchPatch an expensewrite
  • smokeball.matter_expenses.updateUpdate an expensewrite
Matter fees6
  • smokeball.matter_fees.createCreate a feewrite
  • smokeball.matter_fees.deleteDelete a feedestructive
  • smokeball.matter_fees.getGet a feeread
  • smokeball.matter_fees.listGet feesread
  • smokeball.matter_fees.patchPatch a feewrite
  • smokeball.matter_fees.updateUpdate a feewrite
Matters6
  • smokeball.matters.createCreate a matterwrite
  • smokeball.matters.deleteDelete a matterdestructive
  • smokeball.matters.getGet a matterread
  • smokeball.matters.listGet mattersread
  • smokeball.matters.patchPatch a matterwrite
  • smokeball.matters.updateUpdate a matterwrite
Plugins6
  • smokeball.plugins.createCreate a new pluginwrite
  • smokeball.plugins.deleteDelete existing plugindestructive
  • smokeball.plugins.getGet a pluginread
  • smokeball.plugins.listGet pluginsread
  • smokeball.plugins.request_urlRequest plugin URLwrite
  • smokeball.plugins.updateUpdate existing pluginwrite
Webhooks6
  • smokeball.webhooks.createCreate new webhook subscriptionwrite
  • smokeball.webhooks.deleteDeletes a webhook subscriptiondestructive
  • smokeball.webhooks.getGet a webhook subscriptionread
  • smokeball.webhooks.listGet webhook subscriptionsread
  • smokeball.webhooks.notifyNotify a webhook subscriptionwrite
  • smokeball.webhooks.updateUpdate a webhook subscriptionwrite
Activity codes5
  • smokeball.activity_codes.createCreate an activity codewrite
  • smokeball.activity_codes.deleteDelete an activity codedestructive
  • smokeball.activity_codes.getGet an activity coderead
  • smokeball.activity_codes.listGet activity codesread
  • smokeball.activity_codes.updateUpdate an activity codewrite
Contact relations5
  • smokeball.contact_relations.createCreate a contact relationwrite
  • smokeball.contact_relations.deleteDelete a contact relationdestructive
  • smokeball.contact_relations.getGet a contact relationread
  • smokeball.contact_relations.listGet contact relationsread
  • smokeball.contact_relations.updateUpdate a contact relationwrite
Events5
  • smokeball.events.createCreate eventwrite
  • smokeball.events.deleteDelete eventdestructive
  • smokeball.events.getGet an eventread
  • smokeball.events.listGet eventsread
  • smokeball.events.updateUpdate eventwrite
Groups5
  • smokeball.groups.createCreate an authorization groupwrite
  • smokeball.groups.deleteDeletes an authorization groupdestructive
  • smokeball.groups.getGet an authorization groupread
  • smokeball.groups.listGet authorization groupsread
  • smokeball.groups.updateUpdate an authorization groupwrite
Matter layouts5
  • smokeball.matter_layouts.createAdd a new layoutwrite
  • smokeball.matter_layouts.deleteRemove a layoutdestructive
  • smokeball.matter_layouts.getGet a layoutread
  • smokeball.matter_layouts.listGet layoutsread
  • smokeball.matter_layouts.mergeMerge a layoutwrite
Matter memos5
  • smokeball.matter_memos.createCreate a memo on a matterwrite
  • smokeball.matter_memos.deleteDelete a memodestructive
  • smokeball.matter_memos.getGet a memoread
  • smokeball.matter_memos.listGet memos on a matterread
  • smokeball.matter_memos.updateUpdate a memowrite
Matter role relationships5
  • smokeball.matter_role_relationships.createAdd relationship to a rolewrite
  • smokeball.matter_role_relationships.deleteRemove relationship from a role in a matter.destructive
  • smokeball.matter_role_relationships.getGet relationship on a roleread
  • smokeball.matter_role_relationships.listGet relationships on a matterread
  • smokeball.matter_role_relationships.updateUpdate a relationshipwrite
Matter roles5
  • smokeball.matter_roles.createAdd role to a matterwrite
  • smokeball.matter_roles.deleteRemove role from a matterdestructive
  • smokeball.matter_roles.getGet role on a matterread
  • smokeball.matter_roles.listGet roles on a matterread
  • smokeball.matter_roles.updateUpdate role on a matterwrite
Staff5
  • smokeball.staff.createCreate firm staff memberwrite
  • smokeball.staff.deleteDeletes a firm staff memberdestructive
  • smokeball.staff.getGet firm staff memberread
  • smokeball.staff.listSearch firm staff membersread
  • smokeball.staff.updateUpdate firm staff memberwrite
Task subtasks5
  • smokeball.task_subtasks.createCreate a subtaskwrite
  • smokeball.task_subtasks.deleteDelete a subtaskdestructive
  • smokeball.task_subtasks.getGet a subtaskread
  • smokeball.task_subtasks.listGet subtasksread
  • smokeball.task_subtasks.updateUpdate a subtaskwrite
Tasks5
  • smokeball.tasks.createCreate a taskwrite
  • smokeball.tasks.deleteDelete a taskdestructive
  • smokeball.tasks.getGet a taskread
  • smokeball.tasks.listGet tasksread
  • smokeball.tasks.updateUpdate a taskwrite
Event reminders4
  • smokeball.event_reminders.createCreate reminder for an eventwrite
  • smokeball.event_reminders.deleteDelete reminder for an eventdestructive
  • smokeball.event_reminders.listGets reminders for an eventread
  • smokeball.event_reminders.updateUpdate a reminder for an eventwrite
Firm users4
  • smokeball.firm_users.deleteDelete firm user mappingdestructive
  • smokeball.firm_users.getGet firm user mappingread
  • smokeball.firm_users.listGet firm user mappingsread
  • smokeball.firm_users.updateUpdate firm user mappingwrite
Plugin subscriptions4
  • smokeball.plugin_subscriptions.createSubscribe account to pluginwrite
  • smokeball.plugin_subscriptions.deleteUnsubscribes account from plugindestructive
  • smokeball.plugin_subscriptions.getGet a plugin subscriptionread
  • smokeball.plugin_subscriptions.listGet plugin subscriptionsread
Task documents4
  • smokeball.task_documents.createCreate a task documentwrite
  • smokeball.task_documents.deleteDelete a task documentdestructive
  • smokeball.task_documents.getGet a task documentread
  • smokeball.task_documents.listGet task documentsread
Users4
  • smokeball.users.createCreate a userwrite
  • smokeball.users.deleteRemove a userdestructive
  • smokeball.users.getGet a userread
  • smokeball.users.resend_inviteResend sign-in credentialswrite
Bank account transactions3
  • smokeball.bank_account_transactions.createCreate a transactionwrite
  • smokeball.bank_account_transactions.getGet a transactionread
  • smokeball.bank_account_transactions.listGet transactionsread
Contact tags3
  • smokeball.contact_tags.createAdd tags to a contactwrite
  • smokeball.contact_tags.deleteRemove tags from a contactdestructive
  • smokeball.contact_tags.listGet contact tagsread
Firm3
  • smokeball.firm.createCreate firmwrite
  • smokeball.firm.getGet firmread
  • smokeball.firm.updateUpdate firmwrite
Matter archive3
  • smokeball.matter_archive.getGet the archive for a matterread
  • smokeball.matter_archive.patchPatch an archive for a matterwrite
  • smokeball.matter_archive.updateUpdate an archive for a matter.write
Matter billing configuration3
  • smokeball.matter_billing_configuration.getGet matter billing configurationread
  • smokeball.matter_billing_configuration.patchPatch matter billing configurationwrite
  • smokeball.matter_billing_configuration.updateUpdate matter billing configurationwrite
Matter invoices3
  • smokeball.matter_invoices.getGet an invoiceread
  • smokeball.matter_invoices.get_download_urlGet download url for an invoiceread
  • smokeball.matter_invoices.listGet invoicesread
Matter layout contacts3
  • smokeball.matter_layout_contacts.createAdd a contact to a layoutwrite
  • smokeball.matter_layout_contacts.deleteRemove a contact from a layoutdestructive
  • smokeball.matter_layout_contacts.listGet layout contactsread
Matter tags3
  • smokeball.matter_tags.createAdd tags to a matterwrite
  • smokeball.matter_tags.deleteRemove tags from a matterdestructive
  • smokeball.matter_tags.listGet matter tagsread
Policies3
  • smokeball.policies.createCreate an authorization policywrite
  • smokeball.policies.getGet an authorization policyread
  • smokeball.policies.updateUpdate an authorization policywrite
Layouts2
  • smokeball.layouts.getGet a layout designread
  • smokeball.layouts.listGet layout designsread
Matter items2
  • smokeball.matter_items.getGet an item on a matterread
  • smokeball.matter_items.listGet items on a matterread
Matter portal tasks2
  • smokeball.matter_portal_tasks.createCreates a portal taskwrite
  • smokeball.matter_portal_tasks.patchPatch a portal taskwrite
Matter types2
  • smokeball.matter_types.getGet a matter typeread
  • smokeball.matter_types.listGet matter typesread
Notifications2
  • smokeball.notifications.createCreate a notificationwrite
  • smokeball.notifications.getGet a notificationread
Referral types2
  • smokeball.referral_types.getGet a referral typeread
  • smokeball.referral_types.listGet referral typesread
Stage sets2
  • smokeball.stage_sets.getGet a stage setread
  • smokeball.stage_sets.listGet stage sets for the firmread
Files1
  • smokeball.files.searchSearch files with advanced filtersread
Matter integrated search mapping1
  • smokeball.matter_integrated_search_mapping.getGet mappingread
Matter portal messages1
  • smokeball.matter_portal_messages.sendSends a portal messagewrite
Matter stage mappings1
  • smokeball.matter_stage_mappings.listGet stage to matter mappings in the firmread
Matter stages1
  • smokeball.matter_stages.getGet a matter stage informationread
Matter type categories1
  • smokeball.matter_type_categories.listGet matter types categoriesread
Stage set stages1
  • smokeball.stage_set_stages.getGet a stage on a stage setread
User registrations1
  • smokeball.user_registrations.listGet user registrationsread
Webhook event types1
  • smokeball.webhook_event_types.listGet event typesread

Questions

The Smokeball MCP server, answered.

Is there a Smokeball MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 195 Smokeball actions across matter files, matter folders, bank accounts and contacts, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Smokeball.

What do I need to connect Smokeball?

OAuth client id of your Smokeball app (Developer Console > App Details), OAuth client secret of the same Smokeball app (Developer Console > App Details) and Smokeball-issued API key, sent as the x-api-key header on every request. Plus your api host. The free call account { op: "connections.requirements", service: "smokeball" } lists exactly what to paste.

Can an AI agent delete or change things in Smokeball?

Only if its key allows it, and only with an explicit confirmation. 28 Smokeball actions are destructive, including delete a task, delete a matter and deletes a firm staff member. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my Smokeball API limit?

actionlake paces every call to the limits in the Smokeball service file: 5 calls a second per connection. Repeated reads are answered from cache (91 Smokeball actions can be), which never reaches Smokeball.

What does a Smokeball action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (195 Smokeball actions page). Cache hits, searches, dry runs and calls Smokeball refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which Smokeball API does it cover?

The Smokeball API (1.0; OpenAPI 3.0) at api.smokeball.com by default, or the base URL set when you connect. It is built from Smokeball's documentation as read on 23 October 2026. 195 actions in 51 areas, each one in the signed service file (version 1.0.0).

Can I combine Smokeball with my other systems?

Yes. ask joins Smokeball to HaloPSA or HubSpot CRM on the same customer and returns the answer rather than every row. Smokeball maps crm.contact, which 192 other connectors also map.

Does actionlake keep my Smokeball data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Smokeball credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

Give your agent Smokeball today.

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.