Integration

Talkable integration

Talkable runs referral and loyalty programs for online stores. Register purchases, events and advocates (origins), approve, void or refund referrals, look up people with their referrals, rewards and shares, read and share advocate offers, check and look up coupons, manage loyalty points (collect, adjust, redeem), compute program metrics, and manage site assets. Every tool except the two offer share tools takes site_slug, the site ID shown in the Talkable dashboard. Not exposed: the generic and the experimental batch origin routes (silent async validation), and Apple or Google Wallet pass install links (person-bound bearer URLs). Authentication is a Talkable API key (Site Settings, API Integration) sent as a Bearer token; scheduling a metric segmentation needs an api:write key.

Connect Talkable How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with Talkable

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.

Asset, 3 operations

get_assetGet assetGETReads one site asset by id: name, url, content_type, size, width, height and dates.
list_assetsList assetsGETLists the site's uploaded assets (images and other files): id, name, url, content_type, size, width, height, dates, with the total. Paged with page and per_page (at most 100).
upload_assetUpload assetPOSTUploads a file as a site asset; its name comes from the file name, and the upload fails if an asset with that name already exists. Returns the asset with its url.

Segmentize, 3 operations

calculate_segmented_metricCalculate segmented metricGETCalculates a metric split into segments (period, sharing channel, campaign tag or type): one row per segment with its value. Refuses more than 1000 segment combinations; use schedule_metric_segmentation then.
get_metric_segmentationGet metric segmentationGETReads a scheduled metric segmentation: status queued, running, completed (rows under segmented, in no fixed order) or failed (with error_message).
schedule_metric_segmentationSchedule metric segmentationPOSTQueues a large metric segmentation as a background job (needs an api:write key) and returns the job id; read it with get_metric_segmentation. At most 100 per account per 24 hours (429 after).

Collect action, 2 operations

create_collect_actionCreate collect actionPOSTRecords a collect action for a loyalty member, which can award loyalty points per the site's loyalty rules. Returns collected and the member's new balance.
list_collect_actionsList collect actionsGETLists a loyalty member's collect actions (points earned): type, points, date, the action's configured name and description.

Manual adjustment action, 2 operations

adjust_loyalty_pointsAdjust loyalty pointsPOSTAdds or subtracts loyalty points on a member's balance (a real change). Returns the adjustment and the member's new balance.
list_points_adjustmentsList points adjustmentsGETLists the manual points adjustments made to a loyalty member: points, date, and the staff user who made each.

Member, 2 operations

get_loyalty_memberGet loyalty memberGETReads a loyalty member by email: points balance, member dates, custom properties and phone (personal data).
update_loyalty_memberUpdate loyalty memberPUTUpdates a loyalty member's custom properties and member dates (such as a birthday). Values in custom_properties are stored as strings (false becomes f, 123 becomes 123).

Person, 2 operations

get_personGet personGETReads a person in the referral program (personal data): name, email, phone, username, customer id, subscription dates, custom properties, personal claim link and referral, reward and share counts.
update_personUpdate personPUTUpdates a person's details and opt-in or unsubscribe status, or creates the person when none matches person_slug. Returns the person.

Redeem action, 2 operations

list_redeem_actionsList redeem actionsGETLists a loyalty member's redeem actions (points spent): points, date, and the coupon each redemption issued.
redeem_loyalty_pointsRedeem loyalty pointsPOSTRedeems a member's loyalty points for a reward from a redemption batch, spending points and issuing a coupon. Returns the action with its coupon and the new balance.

Reward, 2 operations

list_person_rewardsList person rewardsGETLists the rewards a person earned in the referral program: amount, reason, status, coupon code and incentive description.
list_rewardsList rewardsGETLists the rewards tied to a visitor UUID (the device created with create_visitor): amount, reason, status, coupon code and incentive description.

Affiliate member, 1 operation

create_affiliate_memberCreate affiliate memberPOSTRegisters a customer as an advocate (affiliate member) in a campaign and returns their offer with the claim_url to share and claim_links per sharing channel.

Anonymize, 1 operation

anonymize_personAnonymize personPOSTPERMANENTLY removes or obscures all personal data of a person (an erasure request); it cannot be undone. Returns the anonymized person.

Campaign, 1 operation

list_campaignsList campaignsGETLists the site's campaigns: id, name, status, active flag, appearance, tag names, live period and joinable origin categories.

Claim url status, 1 operation

check_offer_claim_link_statusCheck offer claim link statusGETChecks whether an offer's claim link is still active (active true or false).

Coupon, 1 operation

get_couponGet couponGETLooks up a coupon code: amount, percentage or fixed, single use, used, active, expiry, the associated reward, and whether it is a Talkable coupon (talkable_coupon).

Email, 1 operation

share_offer_by_emailShare offer by emailPOSTSENDS the advocate's offer by email to the recipients (real emails, subject to the campaign's sending limits). Returns sent counts, per-recipient results and any advocate reward.

Event, 1 operation

create_eventCreate eventPOSTRegisters a customer event (a sign-up, an approval, a renewal) for the referral program; it can complete a referral and trigger rewards. Returns the origin and the customer's offer.

Metric, 1 operation

calculate_metricCalculate metricGETCalculates one referral program metric for a period, with optional filters: plain value, formatted value and result type.

Offer, 1 operation

get_advocate_offerGet advocate offerGETReads an advocate offer: claim_url and show_url to share, coupon, incentives and campaign tags; with sharing_channels it also returns claim_links per channel.

Offer claim, 1 operation

share_and_claim_offerShare and claim offerPOSTShares an advocate's offer with a friend and claims it for that friend in one step, which can issue the friend's reward and coupon. Returns the friend reward or why it was not given.

Permission, 1 operation

check_coupon_permissionCheck coupon permissionGETChecks whether a person may use a coupon code: allowed, the reason when not, and each check (unissued, expired, friend offer expired, different owner, already used).

Personal data, 1 operation

get_person_personal_dataGet person personal dataGETReturns all personal data Talkable holds on a person (an access request): names, email, username, customer id, consent dates, and their purchases and events with IP addresses.

Purchase, 1 operation

create_purchaseCreate purchasePOSTRegisters a customer purchase for the referral program; it can complete a referral and trigger rewards. Returns the origin and the customer's offer with its claim_url.

Redemption batch, 1 operation

list_redemption_batchesList redemption batchesGETLists the rewards a loyalty member can buy with points: batch id, points_cost, description, coupons left and the coupon's amount and expiry. Pass the id to redeem_loyalty_points.

Referral, 1 operation

update_referral_statusUpdate referral statusPUTSets the status of the referral tied to a purchase or event (approve or void a reward, flag or block it). Approved and voided referrals cannot be switched to the opposite state.

Referrals as advocate, 1 operation

list_referrals_as_advocateList referrals as advocateGETLists the referrals a person made as advocate: the friends referred (name, email, phone), status, referred subtotal, fraud checks and the rewards given.

Referrals as friend, 1 operation

list_referrals_as_friendList referrals as friendGETLists the referrals in which a person was the referred friend: who referred them (name, email, phone), status, subtotal, fraud checks and rewards.

Refund, 1 operation

refund_originRefund originPOSTMarks a purchase or event as refunded, in full or with a partial refund_subtotal. Returns the updated origin with refunded_at and partially_refunded.

Shares by, 1 operation

list_person_sharesList person sharesGETLists the shares a person made: channel, date, short_url, the offer shared (with its short_url_code), the campaign, and friends and clicks counts.

Social, 1 operation

share_offer_on_socialShare offer on socialPOSTRegisters a share the advocate already made on a social network (call it after sharing). Returns the share with its short_url and any reward the campaign gives for sharing.

Track visit, 1 operation

track_visitor_offer_visitTrack visitor offer visitPUTMarks a visitor offer as visited. Returns ok.

Traffic source, 1 operation

list_traffic_sourcesList traffic sourcesGETLists the traffic source identifiers recorded for the site, usable as traffic_sources filters in the metric tools.

Unsubscribe, 1 operation

unsubscribe_personUnsubscribe personPOSTUnsubscribes a person from Talkable emails (a real opt-out). Returns the person with unsubscribed_at set.

Visitor, 1 operation

create_visitorCreate visitorPOSTRegisters a visitor UUID you generate for a browser or app install; pass it later as uuid to the origin tools and as visitor_uuid to list_rewards. Returns the uuid.

Use Talkable from Claude Code, Cursor or Codex

Connect Talkable in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Talkable 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 Talkable

Create your workspace
Sign up free. Nothing to install.
Connect Talkable once
Add your Talkable 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.