Integration

Ringba integration

Ringba is a call tracking and pay-per-call platform. Through this integration an agent can read and filter the call log (with per-call revenue, payout and cost, and each caller's phone number, which is personal data) and export it, adjust, void or annotate a call's revenue and payout, and manage campaigns (routing to targets and target groups, publishers, default and per-publisher payouts, offers, real-time bidding settings, IVR trees), publishers and their invitations, buyers, targets and target groups, tracking numbers and number pools (buying and releasing numbers charges or frees real phone numbers), blocked numbers, JS tags and conversion webhooks. Not exposed: the real-time bidding ping and TCPA Shield routes (other hosts), the CSV bulk bid modifier upload, the call log tag list (its route answers 404 today), the account addresses routes (street addresses), call transcripts and the IVR tree list; outputs leave out call recording links, SIP target credentials, IVR tree node settings, the targets nested in a target group (read them with list_target_group_targets) and the account's street address. Authentication is an API access token (Security, API Access Tokens in the Ringba app) sent as Authorization: Token <token>, plus the Ringba account ID (starts with RA, also returned by get_account_info), which every route carries in its path.

Connect Ringba How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Ringba.Built from the 138 Ringba tools below, on the connection you add once.

What you can do with Ringba

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Number, 8 operations

add_number_to_poolAdd number to poolPUTAdds a number the account already owns to a number pool.
buy_numberBuy numberPOSTBuys a new phone number for the account, which is billed; with chargeAccountIfNeeded true the default credit card is charged when the balance is too low.
get_numberGet numberGETGet information about a single phone number associated with your account.
list_number_pool_numbersList number pool numbersGETView numbers associated with a number pool in your account.
list_numbersList numbersGETLists the tracking numbers of the account, with their IDs, phone numbers, names, tags and the publisher and campaign each is assigned to.
list_publisher_numbersList publisher numbersGETGet details about the phone numbers associated with a specific publisher.
release_numberRelease numberDELETEReleases a phone number from the account: the number is given up and calls to it stop.
remove_number_from_poolRemove number from poolDELETERemoves a number from a number pool.

Target, 7 operations

add_target_to_groupAdd target to groupPATCHAdds one target to a target group.
create_targetCreate targetPOSTCreates a target (a call destination: a phone number or a SIP URI) with its time zone schedule and optional caps, hours of operation and buyer.
delete_targetDelete targetDELETEDeletes a target from the account.
get_targetGet targetGETReads one target with its stats. SIP credentials are not returned.
list_target_group_targetsList target group targetsGETRetrieve information about a specific target group without the stats for the target group.
list_targetsList targetsGETLists the targets (call destinations) of the account with their numbers or SIP addresses, schedules and caps. SIP credentials are not returned.
remove_target_from_groupRemove target from groupDELETERemoves one target from a target group (the target is kept).

Affiliate, 6 operations

add_campaign_publisherAdd campaign publisherPATCHAdds a publisher to a campaign; this adds no numbers or payout overrides for it.
assign_number_pool_publisherAssign number pool publisherPUTAssigns a publisher to a number pool.
assign_number_publisherAssign number publisherPUTAssigns a number of the account to a publisher.
remove_campaign_publisherRemove campaign publisherDELETERemoves a publisher from a campaign.
remove_number_pool_publisherRemove number pool publisherDELETERemoves a publisher from a number pool.
remove_number_publisherRemove number publisherDELETERemoves a publisher from a number.

Inbound reference, 6 operations

get_campaign_inbound_referencesGet campaign inbound referencesGETLists the publishers, buyers and targets that reference a campaign.
get_number_inbound_referencesGet number inbound referencesGETView the references to a specific number.
get_number_pool_inbound_referencesGet number pool inbound referencesGETGet information about inbound references to a number pool. For example, this request will tell you numbers in the pool and Js Tags associated with the pool.
get_publisher_inbound_referencesGet publisher inbound referencesGETGet all references to a specific publisher. This will show you all campaigns, phone numbers, and users associated with the publisher.
get_target_group_inbound_referencesGet target group inbound referencesGETView all the campaigns that the target group is assigned to and the targets assigned to the target group.
get_target_inbound_referencesGet target inbound referencesGETSee which campaigns on your account reference a target. Multiple campaigns can reference the same target.

Buyer, 5 operations

assign_target_buyerAssign target buyerPUTAssigns a target to a buyer.
assign_target_group_buyerAssign target group buyerPUTAssigns a target group to a buyer.
list_buyersList buyersGETLists the buyers of the account with their IDs, names and contact details.
remove_target_buyerRemove target buyerDELETEUnassigns a target from its buyer; neither is deleted.
remove_target_group_buyerRemove target group buyerDELETEUnassigns a target group from its buyer; neither is deleted.

Publisher, 5 operations

create_publisherCreate publisherPOSTCreates a publisher. Give users access to it afterwards with invite_publisher_user.
delete_publisherDelete publisherDELETEDeletes a publisher. With keepNumbers false its numbers are released from the account; with force true it is deleted even while still referenced.
get_publisherGet publisherGETGet details for a specific publisher.
list_publishersList publishersGETLists the publishers of the account, with their IDs (used by every publisher call), names, sub IDs and settings.
override_publisher_rtb_settingsOverride publisher rtb settingsPATCHOverrides the campaign's RTB settings (caller ID requirement, rate limit, bid settings, bid adjustments) for one publisher, or disables RTB for it.

Campaign, 4 operations

create_campaignCreate campaignPOSTCreates a campaign; optional settings take the vendor defaults named in each field when left out. Add routes with add_campaign_route and publishers with add_campaign_publisher.
delete_campaignDelete campaignDELETEDeletes a campaign from the account.
get_campaignGet campaignGETReads one campaign with its numbers, publishers, routes, payouts, IVR tree and settings. Integration settings are not returned by this integration.
list_campaignsList campaignsGETLists the active campaigns of the account (deleted ones are left out) with their numbers, publishers, routes, payouts and settings.

Invitation, 4 operations

delete_publisher_invitationDelete publisher invitationDELETEDeletes an invitation to a publisher that has not been accepted yet.
get_publisher_invitationGet publisher invitationGETView details about a single invitation to join a publisher.
invite_publisher_userInvite publisher userPOSTSends an email invitation to a Ringba user to join a publisher.
list_publisher_invitationsList publisher invitationsGETView a list of invitations currently associated with a publisher.

Numberpool, 4 operations

create_number_poolCreate number poolPOSTCreates an empty number pool; add numbers with allocate_number_pool_numbers or add_number_to_pool.
delete_number_poolDelete number poolDELETEDeletes a number pool. With keepNumbers false its numbers are released from the account; with force true it is deleted even while used elsewhere.
get_number_poolGet number poolGETGet further information about a single number pool.
list_number_poolsList number poolsGETGet information about all of the number pools associated with your account.

Payout, 4 operations

create_publisher_payout_overrideCreate publisher payout overridePOSTAdds a payout override for one publisher on a campaign, replacing the campaign default for that publisher. Changes what the publisher is paid.
delete_publisher_payout_overrideDelete publisher payout overrideDELETERemoves a payout override from a publisher on a campaign.
list_publisher_payout_overridesList publisher payout overridesGETLists the payout overrides of one publisher on a campaign.
replace_publisher_payout_overridesReplace publisher payout overridesPUTReplaces ALL payout overrides of a publisher on a campaign with the list sent: an override left out of allPayouts is removed. Read them first with list_publisher_payout_overrides.

Allocation job, 3 operations

cancel_number_pool_allocation_jobCancel number pool allocation jobDELETECancels a number allocation job that is still in progress.
get_number_pool_allocation_jobGet number pool allocation jobGETView details about a specific number allocation job currently in progress for a number pool in your account.
list_number_pool_allocation_jobsList number pool allocation jobsGETView information about number allocation jobs currently in progress for number pools in your account.

Blocked number, 3 operations

block_numberBlock numberPOSTBlocks calls from a phone number, a number prefix (area code) or anonymous callers, for one campaign or all, indefinitely or for expInHour hours.
get_blocked_numberGet blocked numberGETView details about a single blocked number.
list_blocked_numbersList blocked numbersGETView all the numbers you currently have blocked, as well as some details about how long and for what campaigns (if specified) they are blocked.

Default payout, 3 operations

create_campaign_default_payoutCreate campaign default payoutPOSTAdds a default payout to a campaign, applied to every publisher without an override: a fixed amount (isRevShare false) or a revenue share. Changes what publishers are paid.
delete_campaign_default_payoutDelete campaign default payoutDELETERemoves a default payout from a campaign.
replace_campaign_default_payoutsReplace campaign default payoutsPUTReplaces ALL default payouts of a campaign with the list sent: a payout left out of allPayouts is removed. Read them first with get_campaign. Changes what publishers are paid.

Js tag, 3 operations

create_number_js_tagCreate number js tagPOSTCreates a JS tag that swaps a number shown on your web page (e164ExistingNumber) for the campaign number or a number pool.
get_number_js_tagsGet number js tagsGETGet Js Tags associated with a specified number.
remove_number_js_tagRemove number js tagDELETERemoves the JS tag from a number.

Rtb, 3 operations

disable_campaign_rtbDisable campaign rtbDELETEDisables real-time bidding for a campaign and removes all its RTB settings; enable_campaign_rtb sets them up again.
enable_campaign_rtbEnable campaign rtbPUTEnables real-time bidding for a campaign for the first time and sets its RTB settings (bid expiration, rate limit, bid settings). To change them later use update_campaign_rtb_settings.
get_campaign_rtb_settingsGet campaign rtb settingsGETReads the real-time bidding (RTB) settings of a campaign; answers an error when RTB is not enabled for it.

Target group, 3 operations

delete_target_groupDelete target groupDELETEDeletes a target group; it must have no targets left (remove them with remove_target_from_group or bulk_update_target_group_targets).
get_target_groupGet target groupGETRetrieve information about a specific target group. This request will automatically include stats for the target group.
list_target_groupsList target groupsGETGet a list of all target groups associated with your account as well as the targets assigned to each group.

Web hook, 3 operations

delete_webhookDelete webhookDELETEDeletes a webhook; calls to its endPointUrl stop being recorded.
get_webhookGet webhookGETGet details about a specific webhook.
list_webhooksList webhooksGETGet all webhooks associated with your account.

Count, 2 operations

get_target_group_statsGet target group statsGETRetrieve only the stats for a specific target group.
get_target_statsGet target statsGETDisplay only the stats for a specific target.

Draft, 2 operations

delete_campaign_draft_offerDelete campaign draft offerDELETEDeletes the campaign's draft offer before it is published.
get_campaign_draft_offerGet campaign draft offerGETRetrieve offers previously created but not yet published for the specified campaign.

Ivrtree, 2 operations

add_campaign_ivr_treeAdd campaign ivr treePOSTAttaches one of the account's IVR trees to a campaign.
remove_campaign_ivr_treeRemove campaign ivr treeDELETERemoves the IVR tree from a campaign.

Published, 2 operations

delete_campaign_published_offerDelete campaign published offerDELETEDeletes the campaign's published offer; publishers can no longer join it.
get_campaign_published_offerGet campaign published offerGETView published offers associated with the campaign.

Reset count, 2 operations

reset_target_countsReset target countsDELETEResets all call counts of a target to zero (its caps start again).
reset_target_group_countsReset target group countsDELETEResets all call counts of a target group to zero.

Route, 2 operations

add_campaign_routeAdd campaign routePOSTAdds a routing destination to a campaign: send targetId for a static target or targetGroupId for a target group, with its priority and weight and its conversion settings (callConversion).
remove_campaign_routeRemove campaign routeDELETERemoves a target or target group route from a campaign, by the route id listed in the campaign's routes (get_campaign).

Stats, 2 operations

list_campaign_statsList campaign statsGETReturns call stats for every campaign that has ever received calls, deleted ones included; active campaigns with no calls yet are not listed.
list_publisher_statsList publisher statsGETReturns call statistics for every publisher of the account.

Affiliate number, 1 operation

add_campaign_publisher_numberAdd campaign publisher numberPATCHAdds a publisher's number from the account to a campaign, so calls to it route through the campaign.

Allocate more number, 1 operation

allocate_number_pool_numbersAllocate number pool numbersPUTBuys the given count of new numbers into a pool, which is billed; with chargeAccountIfNeeded true the credit card is charged when the balance is too low.

Annotate, 1 operation

annotate_callAnnotate callPOSTAdds tags (annotations) to a call so it can be found and filtered in the call log.

Bulk update, 1 operation

bulk_update_target_group_targetsBulk update target group targetsPATCHAdds and/or removes several targets of a target group in one call; send at least one valid target ID in targetAddIds or targetRemoveIds.

Calllog, 1 operation

get_call_logGet call logPOSTReturns the calls between reportStart and reportEnd (UTC, ISO 8601), newest first, with chosen columns, filters and sorting; page with size (max 1000) and offset. Each record carries the caller's phone number (personal data).

Clone, 1 operation

clone_campaignClone campaignPOSTCreates a copy of a campaign with exactly the same settings, named with "- Copy" appended.

Column, 1 operation

list_call_log_columnsList call log columnsGETLists the columns the call log can return, filter and sort by (id, title, type, which roles see it), for the valueColumns, filters and orderByColumns of get_call_log.

Create conversion, 1 operation

create_conversion_webhookCreate conversion webhookPOSTCreates a conversion webhook: an endPointUrl a partner calls with the call ID and revenue in the query string to mark a call converted and add revenue.

Csv, 1 operation

export_call_log_csvExport call log csvPOSTStarts a CSV export of the call log for a date range and returns its job id; call get_call_log_export with it until status is Ready to get the download URL. The file holds callers' phone numbers.

Default number, 1 operation

remove_campaign_default_numberRemove campaign default numberDELETERemoves the default number from a campaign.

Detail, 1 operation

get_call_detailsGet call detailsPOSTReturns the detailed records and events of specific calls, by their inbound call IDs (from get_call_log). Each record carries the caller's phone number (inboundPhoneNumber), personal data of the person who called.

Expand, 1 operation

expand_number_poolExpand number poolPUTBuys the given count of new numbers into a pool, the same as allocate_number_pool_numbers; billed, with chargeAccountIfNeeded as there.

Export, 1 operation

get_call_log_exportGet call log exportGETReads a call log CSV export started by export_call_log_csv: status, and once it is Ready, the URL of the ZIP file to download.

Free number count, 1 operation

get_number_pool_free_countGet number pool free countGETSee how many numbers in a number pool are currently available for calls.

In use, 1 operation

list_number_pool_numbers_in_useList number pool numbers in useGETGet information about numbers in a number pool that are currently being used for a call.

Invite, 1 operation

invite_publisher_to_campaign_offerInvite publisher to campaign offerPOSTSends an invitation to a publisher to join the campaign's published offer, with a message they will see.

Is duplicate, 1 operation

check_duplicate_targetCheck duplicate targetPOSTChecks whether a target would duplicate an existing one by name, phone number or SIP URI, without creating anything.

Number pool, 1 operation

list_number_pool_statsList number pool statsGETReturns call stats for every number pool of the account, for the current day (default) or month.

Offer, 1 operation

list_campaign_offersList campaign offersGETView all offers associated with the campaign. If there are draft offers and published offers present, they will both be displayed in the offers object in the response.

Override, 1 operation

adjust_call_payments_absoluteAdjust call payments absolutePOSTSets a call's buyer revenue and/or publisher payout TO a new absolute amount; set adjustConversion and adjustPayout to choose which. This changes real money figures on the call.

Participant, 1 operation

list_campaign_offer_participantsList campaign offer participantsGETRetrieve a list of publishers currently participating in the offer for the specified campaign.

Pause, 1 operation

pause_campaign_offerPause campaign offerPOSTPauses the campaign's published offer.

Payment, 1 operation

adjust_call_payments_relativeAdjust call payments relativePOSTAdjusts a call's buyer revenue and/or publisher payout BY a relative amount (positive or negative); set adjustConversion and adjustPayout to choose which. This changes real money figures on the call.

Publish, 1 operation

publish_campaign_draft_offerPublish campaign draft offerPOSTPublishes the campaign's draft offer so publishers can see and join it (per its visibility).

Release non used number, 1 operation

release_unused_numbersRelease unused numbersDELETEReleases EVERY number of the account that is not assigned to a publisher, campaign or JS tag. The numbers are given up; check list_numbers first.

Replace, 1 operation

replace_number_pool_numbersReplace number pool numbersPOSTReleases the given count of numbers from a pool and buys the same count of new ones (which numbers is not chosen by the caller). Billed.

Request conversion adjustment, 1 operation

request_call_conversion_adjustmentRequest call conversion adjustmentPOSTBuyer accounts only: asks the admin of the account running the campaign to adjust a call's revenue by a relative amount. Sends a request; the admin decides.

Request conversion override, 1 operation

request_call_conversion_overrideRequest call conversion overridePOSTBuyer accounts only: asks the admin of the account running the campaign to set a call's revenue to an absolute amount. Sends a request; the admin decides.

Ringbaaccount, 1 operation

get_account_infoGet account infoGETReturns the Ringba accounts the API token can use, with each account ID (RA...) other calls need, name, time zone and role. Use it to check a token.

Targetgroup, 1 operation

create_target_groupCreate target groupPOSTCreates an empty target group with its schedule; add targets with add_target_to_group or bulk_update_target_group_targets.

Url, 1 operation

get_publisher_rtb_urlsGet publisher rtb urlsGETReturns the RTB request URLs a publisher sends its bid requests (pings) to for a campaign.

User, 1 operation

list_publisher_usersList publisher usersGETLists the users of a publisher with their email and per-account roles and item access.

Showing the first 120 of 138 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Ringba from Claude Code, Cursor or Codex

Connect Ringba in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Ringba operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Ringba

Create your workspace
Sign up free. Nothing to install.
Connect Ringba once
Add your Ringba connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.