Atlas: 20% higher ROASEnds in34d21h35m22s

Affiliate MCP server

One Server URLEvery AI Client

Add one URL to Claude, ChatGPT, Cursor or your own agent. Sign in with Referly, no API key.

14-day free trial · Full access from day one · Cancel anytime

  • Streamable HTTP, stateless
  • OAuth 2.1 with PKCE, no API key
  • Writes preview before they run

01 / Servers

Two servers, one sign-in

Your affiliate program and your ad tracking.

  • Referly

    Affiliates, sales, commissions and payouts.

    https://mcp.referly.so/mcp

    Saved as referly

  • Referly Atlas

    Spend, ROAS, pixel health and destinations.

    https://mcp.referly.so/atlas

    Saved as referly-atlas

Pick your app for its steps

Claude, ChatGPT, Cursor and the other product names and marks on this page belong to their owners, who are not affiliated with Referly and do not endorse it.

02 / Security

Sign in with Referly. No API key.

OAuth 2.1 with PKCE. You choose the program and what it may do.

  1. 01

    Your app connects

    The server tells it where to sign in.

  2. 02

    You approve

    Pick the program and the access.

  3. 03

    It gets a token

    Short-lived, refreshed, revocable.

Scopes

  • readDefaultreferly

    See affiliates, sales, payouts and reports

  • writereferly

    Change affiliates, rewards, links and settings

  • payouts:preparereferly

    Prepare payout batches, never send money

  • teamreferly

    Invite and manage teammates

  • atlas:readDefaultreferly-atlas

    See Atlas stores, ads and live events

  • atlas:writereferly-atlas

    Change Atlas store and destination settings

  • Payouts are never sent

    They stop at a prepared batch.

  • Changes wait for you

    A preview first, then your OK.

  • Revoke any time

    Settings, AI apps & MCP.

  • Every call is logged

    With the app that made it.

03 / Tools

Every tool, by area

267 tools in eight areas. Open one to see what each does.

Affiliates
  • Affiliates filtered by status, source, plan, tier, group, country, revenue or clicks.

    list_affiliates
    Reads only
  • One affiliate: links, promo codes, plan, tier, onboarding answers, masked payout method.

    get_affiliate
    Reads only
  • Referrals brought by one affiliate.

    get_affiliate_referrals
    Reads only
  • Payouts made to one affiliate.

    get_affiliate_payouts
    Reads only
  • Approve, decline, deactivate, reactivate or ban. Previews, then runs on explicit ids.

    set_affiliate_status
    Asks first
  • Deletes affiliates and their records. Two-step.

    delete_affiliates
    Asks first
  • Name, company, website and social fields of an affiliate.

    update_affiliate_profile
    Changes data
  • Moves affiliates to another commission plan, optionally updating existing referrals.

    set_affiliate_commission_plan
    Asks first
  • A custom rate for one affiliate, or back to the plan rate.

    set_affiliate_commission_rate
    Changes data
  • A one-off bonus with amount, currency and reason. Previews first.

    give_affiliate_bonus
    Asks first
  • Moves affiliates into an affiliate group.

    assign_affiliates_to_group
    Changes data
  • Sets who an affiliate was referred by. Multi-level programs.

    set_affiliate_upline
    Changes data
  • Removes an affiliate's upline.

    remove_affiliate_upline
    Changes data
  • CSV import jobs and their progress.

    list_import_jobs
    Reads only
  • Asks an affiliate to submit a W-9 or W-8. Business and up.

    request_tax_form
    Changes data
  • Tax forms on file per affiliate, status only, never the tax id.

    list_tax_forms
    Reads only
  • Affiliate groups with member counts and sign-up links.

    list_affiliate_groups
    Reads only
  • Creates or renames a group. Creating groups is Business and up.

    upsert_affiliate_group
    Changes data
  • Deletes a group; its members stay, ungrouped.

    delete_affiliate_group
    Asks first
  • The sign-up link that places new affiliates in a group.

    get_group_signup_link
    Reads only
Referrals and sales
  • Referrals with filters: status, affiliate, plan, date and customer.

    list_referrals
    Reads only
  • One referral with its timeline of clicks, sign-up and sales.

    get_referral
    Reads only
  • Records a referral by hand for an affiliate.

    create_referral
    Changes data
  • Changes a referral's name, email or status.

    update_referral
    Changes data
  • Internal notes on a referral.

    update_referral_notes
    Changes data
  • Moves referrals to another commission plan. Previews first.

    set_referral_commission_plan
    Asks first
  • Approves, holds or declines referrals in bulk. Previews first.

    set_referral_status
    Asks first
  • Deletes referrals and their sales. Two-step.

    delete_referrals
    Asks first
  • Exempts a referral from fraud rules.

    set_referral_fraud_exemption
    Changes data
  • Sales and commissions with status, paid-out, type, group and amount filters.

    list_transactions
    Reads only
  • One sale or commission with its manual payment proof, if any.

    get_transaction
    Reads only
  • Records a sale for a referral with amount, currency and rate. Previews first.

    create_sale
    Asks first
  • Changes a sale's revenue or commission. Previews first.

    update_sale
    Asks first
  • Deletes sales. Two-step.

    delete_sales
    Asks first
  • Tracking links by affiliate with click counts.

    list_affiliate_links
    Reads only
  • Creates a tracking link for an affiliate.

    create_affiliate_link
    Changes data
  • Changes a link's destination or label.

    update_affiliate_link
    Changes data
  • Deletes a tracking link.

    delete_affiliate_link
    Asks first
  • The destinations affiliates can link to, and whether they may add their own.

    update_program_base_urls
    Asks first
  • Automated and Shopify short-link settings.

    get_short_link_settings
    Reads only
  • Changes short-link settings.

    update_short_link_settings
    Asks first
  • Domains available for short links.

    list_short_link_domains
    Reads only
  • Coupons with their discount, duration and promo codes.

    list_coupons
    Reads only
  • One coupon and its promo codes.

    get_coupon
    Reads only
  • Creates a coupon and its codes in Stripe, Shopify or Polar too. Previews first.

    create_coupon
    Asks first
  • Changes a coupon. Previews first.

    update_coupon
    Asks first
  • Deletes coupons. Two-step.

    delete_coupons
    Asks first
  • Pulls coupons from Stripe, Shopify, WooCommerce, Polar, Creem or Ecwid.

    sync_integration_coupons
    Changes data
  • Promo codes and which affiliate each belongs to.

    list_promo_codes
    Reads only
  • Adds a promo code to a coupon for an affiliate.

    create_promo_code
    Changes data
  • Changes a promo code's affiliate or state.

    update_promo_code
    Changes data
  • Archives a promo code.

    archive_promo_code
    Changes data
  • Deletes a promo code.

    delete_promo_code
    Asks first
  • Rules that generate a code for every new affiliate.

    update_auto_coupon_rules
    Asks first
Commissions and rewards
  • Accept, hold or decline commissions in bulk. Previews, then runs on explicit ids.

    set_commission_status
    Asks first
  • Marks commissions refunded so they leave the next payout.

    mark_commissions_refunded
    Asks first
  • Marks commissions paid outside Referly.

    mark_commissions_paid
    Asks first
  • Commission plans with type, rate, trigger and affiliate counts.

    list_commission_plans
    Reads only
  • One plan with its rules, tiers and overrides.

    get_commission_plan
    Reads only
  • Creates or edits a plan. Re-submits existing rules so none are dropped.

    upsert_commission_plan
    Asks first
  • Makes a plan the default for new affiliates.

    set_default_commission_plan
    Asks first
  • Deletes a plan and moves its affiliates to another.

    delete_commission_plan
    Asks first
  • The sign-up link that places new affiliates on a plan.

    get_commission_plan_signup_link
    Changes data
  • Performance tiers and their thresholds.

    list_commission_tiers
    Reads only
  • Creates or edits a tier.

    upsert_commission_tier
    Asks first
  • Deletes a tier.

    delete_commission_tier
    Asks first
  • Multi-level settings: levels and rates.

    get_mlm_settings
    Reads only
  • Changes multi-level levels and rates.

    update_mlm_settings
    Asks first
  • Performance bonuses with status. Gamify add-on.

    list_performance_bonuses
    Reads only
  • One bonus with its rule and awards.

    get_performance_bonus
    Reads only
  • Creates or edits a bonus as a draft, disabled until you enable it.

    upsert_performance_bonus
    Changes data
  • Turns a bonus on or off. Enabling notifies eligible affiliates.

    set_performance_bonus_enabled
    Asks first
  • Deletes a bonus.

    delete_performance_bonus
    Asks first
  • Who would earn a bonus if it applied to past results.

    preview_retroactive_awards
    Reads only
  • Schedules those past awards. Previews first.

    schedule_retroactive_awards
    Asks first
  • Queues the bonus announcement email to eligible affiliates. Shows the count first.

    schedule_performance_bonus_emails
    Asks first
  • Contests with state and dates.

    list_contests
    Reads only
  • One contest with rankings and winners.

    get_contest
    Reads only
  • Creates or edits a contest as a draft.

    upsert_contest
    Changes data
  • Publishes, toggles or finalises a contest.

    set_contest_state
    Asks first
  • Deletes a contest.

    delete_contest
    Asks first
  • Leaderboard visibility and ranking settings.

    get_leaderboard_settings
    Reads only
  • Changes leaderboard settings.

    update_leaderboard_settings
    Changes data
  • The current leaderboard.

    get_leaderboard_rankings
    Reads only
  • Content reward campaigns and submissions at a glance.

    get_content_rewards_overview
    Reads only
  • Content reward campaigns with state.

    list_content_reward_campaigns
    Reads only
  • One content reward campaign: schedule, rules, reward formula, budget and audience.

    get_content_reward_campaign
    Reads only
  • Creates or edits a content reward campaign as a draft.

    upsert_content_reward_campaign
    Changes data
  • Starts, pauses or ends a content reward campaign.

    set_content_reward_campaign_state
    Asks first
  • Deletes a content reward campaign.

    delete_content_reward_campaign
    Asks first
  • Affiliate content submissions awaiting review.

    list_content_submissions
    Reads only
  • Approves or rejects submissions in bulk. Previews first.

    review_content_submission
    Asks first
  • Queues a content campaign's announcement email. Shows the recipient count first.

    schedule_content_reward_emails
    Asks first
Payouts
  • Payout batches with totals, method and paid state.

    list_payout_batches
    Reads only
  • One batch and the payouts in it.

    get_payout_batch
    Reads only
  • One payout with its transfer status.

    get_payout
    Reads only
  • What is due at the next payout date, per affiliate.

    get_upcoming_payouts
    Reads only
  • Counts and totals a batch would contain for a date range and minimum. Nothing is created.

    preview_payout_generation
    Reads only
  • Prepares payout batches. Nothing is sent; you pay from the dashboard.

    create_payout_batches
    Asks first
  • Prepares a batch from chosen commissions. Nothing is sent.

    create_payout_batch_from_transactions
    Asks first
  • Wise, PayPal or Referly Payouts fees for a batch.

    get_payout_fee_estimate
    Reads only
  • Marks a batch or payout paid outside Referly. With proof, use the dashboard.

    mark_payouts_paid
    Asks first
  • Reverts a payout to unpaid.

    mark_payouts_unpaid
    Asks first
  • Bank payout rows as CSV-ready data.

    export_bank_payout_rows
    Reads only
  • Deletes an unpaid batch.

    delete_payout_batch
    Asks first
  • Returns the dashboard link to pay a batch. Money never moves from the assistant.

    get_payout_execution_link
    Reads only
  • Methods, eligibility days, minimum and frequency.

    get_payout_settings
    Reads only
  • Methods, eligibility days, minimum and frequency. Auto-pay switches stay in the dashboard.

    update_payout_settings
    Changes data
Recruiting and outreach
  • Invites one affiliate by email, with names, group and plan.

    invite_affiliate
    Changes data
  • Creates an affiliate account directly, without an invitation.

    create_affiliate
    Changes data
  • Resends a pending invitation.

    resend_affiliate_invitation
    Changes data
  • Program announcements with status and audience.

    list_announcements
    Reads only
  • One announcement with its content and results.

    get_announcement
    Reads only
  • Creates or edits an announcement as a draft. Publishing is a separate step.

    upsert_announcement
    Changes data
  • Publish, pause, resume, archive or unschedule. Publishing sends.

    set_announcement_state
    Asks first
  • Deletes an announcement.

    delete_announcement
    Asks first
  • Copies an announcement as a new draft.

    duplicate_announcement
    Changes data
  • Who an announcement would reach, as a count and a list.

    preview_announcement_audience
    Reads only
  • Responses to a poll announcement.

    get_poll_results
    Reads only
  • Portal popups and banners with status.

    list_popups_banners
    Reads only
  • One popup or banner.

    get_popup_banner
    Reads only
  • Creates or edits a portal popup or banner.

    upsert_popup_banner
    Changes data
  • Turns a popup or banner on or off. Business and up.

    set_popup_banner_status
    Asks first
  • Copies a pop-up or banner into a new draft with the same settings.

    duplicate_popup_banner
    Changes data
  • Deletes a popup or banner.

    delete_popup_banner
    Asks first
  • Marketing asset folders and who can see them.

    list_asset_folders
    Reads only
  • Logos, banners, links and videos shared with affiliates.

    list_assets
    Reads only
  • Creates an asset folder.

    create_asset_folder
    Changes data
  • Adds or edits text, link and YouTube assets. File uploads stay in the dashboard.

    upsert_assets
    Asks first
  • Deletes a folder and its assets.

    delete_asset_folder
    Asks first
  • Files in the content library.

    list_media_files
    Reads only
  • Conversations with affiliates. Business and up.

    list_chat_rooms
    Reads only
  • Messages in one conversation.

    get_chat_messages
    Reads only
  • Sends a text message to an affiliate or a group room.

    send_chat_message
    Changes data
  • Starts a group conversation. Engage add-on.

    create_group_room
    Changes data
  • Adds or removes affiliates from a group room.

    update_room_members
    Changes data
  • Archives a conversation.

    archive_room
    Changes data
  • Deletes a conversation.

    delete_room
    Asks first
  • Creators by niche, platform, audience and engagement. Discovery add-on.

    search_influencers
    Reads only
  • One creator's profile and match breakdown. Never their email.

    get_influencer
    Reads only
  • Saves a creator to your shortlist.

    save_influencer
    Changes data
  • Removes a creator from your shortlist.

    unsave_influencer
    Changes data
  • Your shortlisted creators.

    list_saved_influencers
    Reads only
  • How many creator invitations you have left this period.

    get_invitations_remaining
    Reads only
  • Sends a program invitation to a creator. Counts against your quota.

    send_influencer_invitation
    Asks first
  • Your listing on the Referly marketplace and its score breakdown.

    get_marketplace_listing
    Reads only
  • Edits your marketplace listing.

    update_marketplace_listing
    Changes data
Program setup
  • Every program you can see: id, name, currency, plan and your role. Resolves names to ids.

    list_programs
    Reads only
  • Every setting in one read: tracking, approvals, fraud, invoices, payouts, portal URL.

    get_program
    Reads only
  • Every program email with its type, whether it is customised, on or off, and open stats.

    list_program_emails
    Reads only
  • Subject and body of one program email.

    get_email_content
    Reads only
  • Replaces an email's subject and body.

    update_email
    Changes data
  • Turns a customised email on or off.

    toggle_custom_email
    Changes data
  • Sends one email to yourself to check it.

    send_test_email
    Changes data
  • Who at your company is notified about sign-ups, sales and payouts.

    update_notification_recipients
    Changes data
  • DNS and verification state of your sending domain.

    get_sending_domain_status
    Reads only
  • Branding, copy, login options, languages, widget and onboarding settings of the portal.

    get_portal_settings
    Reads only
  • Logo, colours and favicon of the affiliate portal.

    update_portal_branding
    Changes data
  • Headline, description and sign-up copy shown to affiliates.

    update_portal_copy
    Changes data
  • Which sign-in methods the portal offers. Social-login secrets stay in the dashboard.

    update_portal_login_settings
    Changes data
  • Terms, cookie duration, hide-branding, minimum payout and manual referral submission.

    update_portal_other_settings
    Changes data
  • Default locale and the languages affiliates can switch to.

    update_portal_languages
    Changes data
  • The contact details and widget shown inside the portal.

    update_contact_widget
    Changes data
  • Which customer fields affiliates can see on their referrals.

    update_shared_customer_data
    Changes data
  • The onboarding steps a new affiliate completes in the portal.

    update_portal_onboarding
    Changes data
  • Custom portal domains and their verification state.

    list_custom_domains
    Reads only
  • Adds a custom domain for the portal and returns the DNS records to set.

    add_custom_domain
    Changes data
  • Re-checks DNS and certificate status for a custom domain.

    check_custom_domain
    Reads only
  • Removes a custom domain. The portal falls back to its Referly subdomain.

    delete_custom_domain
    Asks first
  • Returns the links for custom CSS and JS, Google sign-in and reCAPTCHA keys.

    get_portal_custom_code_link
    Reads only
  • Name, currency, tracking, cookie window, fraud rules, landing pages and invoice settings.

    get_program_settings
    Reads only
  • Name, currency, URL parameter and auto-approve. Previews first; currency is relabelled.

    update_program_settings
    Asks first
  • Adds a landing page affiliates can link to, optionally for chosen groups only.

    add_base_url
    Asks first
  • Removes a landing page. Previews first; the last page always stays.

    remove_base_url
    Asks first
  • Whether new affiliates, referrals and sales are approved automatically.

    update_auto_approve_settings
    Changes data
  • Deduct taxes, fees or discounts from the amount a commission is calculated on.

    update_commission_deduction_settings
    Changes data
  • Self-referral blocks, duplicate-customer rules and hold periods.

    update_fraud_prevention_settings
    Changes data
  • Switch the tracking method and the cookie window.

    update_tracking_method
    Changes data
  • Domains sharing one tracking session across your sites.

    list_cross_tracking_domains
    Reads only
  • Adds a domain to cross-domain tracking.

    add_cross_tracking_domain
    Changes data
  • Removes a domain from cross-domain tracking.

    remove_cross_tracking_domain
    Changes data
  • Self-billing invoice details issued to affiliates on payout. Business and up.

    update_invoice_settings
    Changes data
  • The extra questions on your affiliate sign-up form.

    update_custom_questions
    Asks first
  • Whether a portal subdomain is free. Changing it is a dashboard action.

    check_subdomain
    Reads only
  • Returns the link for deleting a program or changing its subdomain. Never done here.

    get_program_danger_zone_link
    Reads only
  • Team members and the programs each can access.

    list_team_members
    Reads only
  • Pending team invitations.

    list_team_invitations
    Reads only
  • Invites teammates as members with explicit program access. Owner only.

    invite_team_members
    Changes data
  • Changes a member's role.

    change_team_member_role
    Changes data
  • Changes which programs a member can access.

    update_member_programs
    Changes data
  • Removes a teammate's access.

    remove_team_member
    Asks first
  • Cancels a pending team invitation.

    revoke_team_invitation
    Changes data
  • Resends a pending team invitation.

    resend_team_invitation
    Changes data
  • Plan, limits, usage, add-ons and trial state. Nothing here changes billing.

    get_billing_summary
    Reads only
  • Returns the link to your billing portal. Plan changes stay in the dashboard.

    get_billing_portal_link
    Changes data
  • Returns the upgrade link for the plan that unlocks a gated feature.

    get_upgrade_link
    Reads only
  • Client programs, their status and subscriptions. Agency accounts.

    get_agency_dashboard
    Reads only
  • Every client program under the agency with its subscription state.

    list_agency_programs
    Reads only
  • Creates a client program, optionally from a website.

    create_agency_program
    Asks first
  • Which features a client program can use.

    update_agency_program_features
    Changes data
  • Affiliate, revenue and seat limits for a client program.

    update_agency_program_limits
    Changes data
  • Who pays for a client program and whether it is current.

    get_agency_program_billing_status
    Reads only
  • Returns the link for agency plan changes, exemptions and white-label settings.

    get_agency_dashboard_link
    Reads only
  • Your dashboard notifications, newest first.

    list_notifications
    Reads only
  • Marks notifications as read.

    mark_notifications_read
    Changes data
  • Which setup steps are done and what is left.

    get_setup_checklist
    Reads only
Tracking, reports and integrations
  • KPIs, top affiliates and breakdowns for a period. Defaults to the last 30 days.

    get_program_overview
    Reads only
  • Your top five affiliates for a period by revenue, referrals or clicks, with the change.

    list_top_affiliates
    Reads only
  • Overview, chart, funnel and breakdown by affiliate, link, coupon, country or device.

    get_performance_report
    Reads only
  • Where new affiliates came from, by channel and period. Engage add-on.

    get_acquisition_report
    Reads only
  • Recent partner activity: sign-ups, first clicks, first sales and who has gone quiet.

    get_partner_activity
    Reads only
  • Text search across affiliates, referrals, sales, links and coupons in one program.

    search
    Reads only
  • One record by kind and id as title, text and dashboard URL. Pairs with search.

    fetch
    Reads only
  • Which integration is connected, which setup steps are done and what is missing.

    get_integration_setup_status
    Reads only
  • The exact script tag or install snippet for this program.

    get_tracking_snippet
    Reads only
  • Fetches your site and reports whether the tracking script is live and on which pages.

    verify_tracking_script
    Changes data
  • Every integration for tracking, sales or coupons, and which are connected.

    list_available_integrations
    Reads only
  • Marks a setup step complete in the integration wizard.

    mark_integration_step_done
    Changes data
  • Webhook endpoints with their URL, events and enabled state.

    list_webhook_endpoints
    Reads only
  • Creates or updates an endpoint and the events it subscribes to.

    upsert_webhook_endpoint
    Changes data
  • Pauses or resumes an endpoint.

    set_webhook_endpoint_enabled
    Changes data
  • Deletes a webhook endpoint.

    delete_webhook_endpoint
    Asks first
  • Fires a sample of one event type at an endpoint.

    send_test_webhook
    Changes data
  • Delivery attempts with status codes and responses, newest first.

    get_webhook_logs
    Reads only
  • Replays one past message to its endpoint.

    resend_webhook
    Changes data
  • Every event type an endpoint can subscribe to.

    list_webhook_event_types
    Reads only
  • Settings of the customer-facing referral widget.

    get_referral_widget_settings
    Reads only
  • Changes the referral widget's copy, colours and placement.

    update_referral_widget_settings
    Changes data
  • Views, shares and sign-ups through the referral widget.

    get_widget_analytics
    Reads only
  • Returns the link to connect Stripe, Shopify and the rest, or rotate secrets.

    get_integrations_dashboard_link
    Reads only
Atlas ad attribution
  • Workspaces and stores with status, platform and ids.

    atlas_list_workspaces_and_stores
    Reads only
  • Store settings and setup status. Never the API token.

    atlas_get_store
    Reads only
  • Wizard state, destinations and a dry connection test. Drives the setup help.

    atlas_get_setup_status
    Reads only
  • Pauses event delivery for a store.

    atlas_pause_store
    Asks first
  • Resumes event delivery for a store.

    atlas_resume_store
    Asks first
  • Name, timezone, currency, attribution window, consent mode, test mode and domains.

    atlas_update_store_settings
    Asks first
  • Marks a setup wizard step done.

    atlas_mark_wizard_step
    Changes data
  • KPIs and the orders Atlas recovered for a period.

    atlas_get_overview
    Reads only
  • Orders with search and status, fifty a page.

    atlas_list_orders
    Reads only
  • Conversions and the conversions report.

    atlas_list_conversions
    Reads only
  • Report table grouped by UTM, campaign or ad set, with filters and sort.

    atlas_get_report
    Reads only
  • The values you can filter a report by.

    atlas_get_report_filter_options
    Reads only
  • A report as markdown for an agent to read. Five a minute.

    atlas_export_report
    Reads only
  • The last events and deliveries, as they arrive.

    atlas_get_live_feed
    Reads only
  • Ad platforms receiving events, with enabled events and last test. Credentials masked.

    atlas_list_destinations
    Reads only
  • Label, enabled events and settings of a destination. Credentials stay in the dashboard.

    atlas_update_destination
    Changes data
  • Sends a real test event to an ad platform.

    atlas_send_destination_test_event
    Changes data
  • Event filter groups.

    atlas_get_event_filters
    Reads only
  • Replaces an event filter group. Previews first.

    atlas_save_event_filter_group
    Asks first
  • Spend, ROAS and the period comparison across ad accounts.

    atlas_get_ad_center_overview
    Reads only
  • Campaigns, ad sets or ads with spend, revenue and ROAS.

    atlas_get_ad_table
    Reads only
  • Finds campaigns, ad sets and ads by name.

    atlas_search_ad_entities
    Reads only
  • Creative performance, series and details.

    atlas_get_creative_report
    Reads only
  • Ad center data as markdown for an agent to read.

    atlas_export_ad_center
    Reads only
  • Connected ad accounts, sync state and mapping health.

    atlas_get_ad_accounts_health
    Reads only
  • Lookback, thresholds and weekly report settings.

    atlas_get_pulse_settings
    Reads only
  • Refreshes ad data. Once every five minutes per workspace.

    atlas_refresh_ad_center
    Changes data
  • Sets a store's niche for Ad center benchmarks and the weekly report.

    atlas_set_store_niche
    Changes data
  • Changes an ad account's sync settings.

    atlas_update_ad_account_sync
    Changes data
  • Re-syncs an ad account.

    atlas_resync_ad_account
    Changes data
  • Lookback, thresholds and weekly report recipients.

    atlas_update_pulse_settings
    Changes data
  • Sends the weekly report to yourself.

    atlas_send_weekly_report_test
    Changes data
  • Entitlement and plan. No invoices.

    atlas_get_billing
    Reads only
  • Team members and their store access.

    atlas_list_team
    Reads only
  • Invites a teammate with a role and store access.

    atlas_invite_team_member
    Changes data
  • Time zone, display currency, weekly report and alert preferences.

    atlas_get_preferences
    Reads only
  • Your Atlas preferences.

    atlas_update_preferences
    Changes data

04 / Any client

Config for any MCP client

Use the first one your app accepts.

  1. 01

    Remote URL

    Most apps. They open the Referly sign-in.

    mcp.json
    {  "mcpServers": {    "referly": {      "type": "http",      "url": "https://mcp.referly.so/mcp"    }  }}
  2. 02

    mcp-remote bridge

    Apps that only run local servers. Needs Node.

    mcp.json
    {  "mcpServers": {    "referly": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mcp.referly.so/mcp"      ]    }  }}
  3. 03

    Personal token

    Scripts, CI and agents with no browser.

    Create one in Settings, AI apps & MCP. Revoke it there. Treat it like a password.

    mcp.json
    {  "mcpServers": {    "referly": {      "url": "https://mcp.referly.so/mcp",      "headers": {        "Authorization": "Bearer rfk_…"      }    }  }}

05 / Atlas

The Atlas server

Referly Atlas has its own URL and its own scopes. Add it next to the Referly server, or on its own.

https://mcp.referly.so/atlas
mcp.json
{  "mcpServers": {    "referly-atlas": {      "type": "http",      "url": "https://mcp.referly.so/atlas"    }  }}

FAQ

Before you wire it up

Referly runs two remote MCP servers over Streamable HTTP: https://mcp.referly.so/mcp for your affiliate program and https://mcp.referly.so/atlas for Referly Atlas. Any MCP client can add the URL. You sign in with your Referly account through OAuth 2.1, so there is no API key. Reads run on their own, writes preview first, and payouts stop at a prepared batch.

14-day free trial · Full access from day one · Cancel anytime

  • Streamable HTTP over POST, stateless. Clients that only run local servers, or still expect SSE, can use the mcp-remote bridge.

Step by step

Guides for each assistant

The exact menu path or command for each client, on its own page.