Developer Tools
amba.dev
Manages developer accounts for Amba, including signup, login, verification, and token refresh.
ENDPOINT 1
https://mcp.amba.dev/mcp
MCP server metadata
- Name
- amba
- Version
- 0.1.0
Amba is the backend your app calls at runtime via the SDK; the tools below are for provisioning, called by the coding agent. Before using any tool: ensure the SDK is installed + initialized in this codebase. Use clientKey for code that ships to users (browser/mobile/native); serverKey for code that runs on your servers. NEVER embed serverKey in client. Surface areas (prefer over hand-rolled equivalents for net-new): identity, engagement (push/segments/onboarding/content/referrals/deeplinks), gamification (xp/achievements/streaks/leaderboards/challenges), economy (currencies/catalog/stores/inventory), social (friendships/groups/messaging/feeds/reviews/moderation), analytics, infrastructure (collections/functions/sites/media/secrets/configs/integrations/ai_prompts). Bootstrap: call amba_developer_signup (no auth needed). Response includes PAT + project keys + ready-to-paste MCP config snippets. Pass pat on every subsequent tool call this session; write the matching snippet to the user's MCP config for future sessions (no restart needed). Full guide: amba://setup
Known tools 520
amba_affiliate_signupJoin an affiliate program from zero: create an Amba account + org and get a long-lived PAT plus ready-to-paste MCP-client config in `mcp_config`.
Potential side effectsamba_developer_verifyVerify a developer account headlessly using the `verify_token` returned by `amba_developer_signup`.
Inferred read-onlyamba_developer_refreshRotate a developer access_token using the refresh_token previously issued by signup or login.
Inferred read-onlyamba_developer_meReturn the developer profile (id, email, name, oauth_providers, avatar_url, github_username) for the Bearer currently in effect (either the `pat` argument or the inbound HTTP Authorization header).
Potential side effectsamba_projects_getGet detailed information about a specific Amba project by its ID, including API keys, integrations, and configuration.
Inferred read-onlyamba_get_projectGet detailed information about a specific Amba project by its ID, including API keys, integrations, and configuration.
Inferred read-onlyamba_orgs_listList organizations the authenticated developer can access, including descendant orgs in the hierarchy.
Inferred read-onlyamba_orgs_getGet an organization by id, including its child-org and project counts and your effective role.
Inferred read-onlyamba_orgs_transfer_ownerTransfer ownership of an organization to another developer (who must already be reachable).
Potential side effectsamba_provision_appApp factory: atomically create a child org + a project under it and return the project keys.
Potential side effectsamba_affiliate_programs_updateUpdate an affiliate program (status, payout config, fee, approval mode, conversion definition, attribution, multi-level).
Potential side effectsamba_affiliate_affiliates_listList a program’s affiliates with their conversion + commission totals.
Inferred read-onlyamba_affiliate_affiliate_approveApprove (activate) a pending affiliate enrollment.
Inferred read-onlyamba_affiliate_affiliate_banBan an affiliate from a program (links die; pending conversions voided).
Inferred read-onlyamba_affiliate_affiliate_pausePause an affiliate enrollment (their links stop earning; reversible via approve).
Inferred read-onlyamba_affiliate_affiliates_getGet one affiliate enrollment with its codes, conversions, and commission totals.
Inferred read-onlyamba_affiliate_conversions_listList conversions for a program (optionally filter by status).
Inferred read-onlyamba_affiliate_conversion_approveApprove a pending conversion so it accrues commission.
Inferred read-onlyamba_affiliate_conversion_rejectReject a pending conversion so it never accrues commission.
Inferred read-onlyamba_affiliate_conversion_clawbackClaw back an approved/paid conversion (the underlying sale refunded or charged back).
Inferred read-onlyamba_affiliate_analytics_getProgram-level analytics: conversion + commission totals and an affiliate leaderboard.
Inferred read-onlyamba_affiliate_leaderboard_getAffiliate leaderboard for a program: top affiliates by commission, with clicks + EPC.
Inferred read-onlyamba_affiliate_payouts_listSettlement (payout) history for a program’s affiliates: net amount, period, transfer id, status.
Potential side effectsamba_affiliate_payout_runRun payouts for a program: pay each affiliate org their payable commissions over the threshold via Stripe Connect.
Potential side effectsamba_affiliate_my_programs_listList the affiliate programs your org(s) are enrolled in.
Inferred read-onlyamba_affiliate_my_invites_listList affiliate-program invitations pending for your org(s).
Inferred read-onlyamba_affiliate_my_invite_acceptAccept an affiliate-program invitation addressed to your org (activates the enrollment and returns your referral code).
Inferred read-onlyamba_affiliate_my_referral_generateMint a FRESH referral code for a program you are enrolled in (rotates/replaces your current active code).
Inferred read-onlyamba_affiliate_my_conversions_listList conversions across your affiliate enrollments (optionally filter by status).
Inferred read-onlyamba_affiliate_my_payout_requestCheck what one of your orgs is owed and whether its payout account is ready.
Inferred read-onlyamba_affiliate_my_referral_getGet your referral code(s) / link(s) for a program you are enrolled in.
Inferred read-onlyamba_affiliate_my_stats_getYour affiliate stats across all enrollments: conversions, earnings, pending vs paid.
Inferred read-onlyamba_affiliate_my_balance_getYour available (unpaid) and lifetime-paid commission balance, per currency.
Inferred read-onlyamba_affiliate_my_payout_createCreate a Stripe Connect payout account for an org you own (so you can receive commissions).
Potential side effectsamba_affiliate_my_payout_onboardingGet a hosted Stripe onboarding URL to finish setting up an org’s payout account.
Inferred read-onlyamba_push_campaigns_createCreate a new push notification campaign for a project.
Potential side effectsamba_create_push_campaignCreate a new push notification campaign for a project.
Potential side effectsamba_push_campaigns_sendSend (trigger delivery of) a previously created push campaign.
Potential side effectsamba_send_push_campaignSend (trigger delivery of) a previously created push campaign.
Potential side effectsamba_push_list_campaignsList push notification campaigns for a project, ordered by most recent.
Inferred read-onlyamba_push_get_campaignGet a single push campaign by ID including its current status (draft, scheduled, sending, sent, failed), schedule, and payload.
Inferred read-onlyamba_segments_getGet a single segment by id including its rules and is_system flag.
Inferred read-onlyamba_segments_patchUpdate a non-system segment's name, description, and/or rules.
Potential side effectsamba_content_items_addAdd one or more content items to an existing content library.
Inferred read-onlyamba_add_content_itemsAdd one or more content items to an existing content library.
Inferred read-onlyamba_content_schedules_createCreate a delivery schedule for a content library.
Potential side effectsamba_content_translations_listList every per-language translation for a content item (one row per language).
Inferred read-onlyamba_content_translations_deleteDelete a single per-language translation for a content item.
Potential side effectsamba_content_bulk_importBulk-import multiple content items into a library in a single transactional call.
Inferred read-onlyamba_streaks_resetReset or correct a specific user's streak — for support fixing a wrongly-broken streak (e.g.
Inferred read-onlyamba_integrations_configureConfigure (create or replace) a third-party integration for a project.
Potential side effectsamba_configure_integrationConfigure (create or replace) a third-party integration for a project.
Potential side effectsamba_integrations_testTest an existing integration to verify it is configured correctly and can connect to the third-party service.
Inferred read-onlyamba_test_integrationTest an existing integration to verify it is configured correctly and can connect to the third-party service.
Inferred read-onlyamba_integrations_setCreate or replace an integration (upsert by project+provider).
Potential side effectsamba_integrations_patchPatch an existing integration — update its config and/or toggle is_active.
Potential side effectsamba_users_getGet a single app user by id, with their streaks and entitlements joined in.
Inferred read-onlyamba_users_events_exportExport one user's engagement events as CSV (default) or NDJSON.
Inferred read-onlyamba_users_bulk_updateApply property merges and/or segment add/remove to up to 1000 users in a single transactional call.
Potential side effectsamba_users_create_cohortMint N anonymous app_users at once, all sharing the same properties (and, optionally, the same segment memberships) in a single call.
Inferred read-onlyamba_users_reset_userReset ONE app user to a brand-new state WITHOUT deleting them.
Inferred read-onlyamba_sessions_analyticsGet session analytics (DAU, active users, total sessions, average and median session duration) for a project across a rolling window.
Inferred read-onlyamba_sdk_get_setup_instructionsGet platform-specific code snippets and setup instructions for integrating the Amba client SDK into a mobile app.
Inferred read-onlyamba_get_sdk_setup_instructionsGet platform-specific code snippets and setup instructions for integrating the Amba client SDK into a mobile app.
Inferred read-onlyamba_achievements_listList all achievement definitions for a project, including criteria and XP rewards.
Inferred read-onlyamba_list_achievementsList all achievement definitions for a project, including criteria and XP rewards.
Inferred read-onlyamba_achievements_getFetch a single achievement definition by ID, including criteria and XP reward.
Inferred read-onlyamba_get_achievementFetch a single achievement definition by ID, including criteria and XP reward.
Inferred read-onlyamba_achievements_grantManually award an achievement to a specific user (marks it unlocked now).
Inferred read-onlyamba_achievements_revokeClaw back an achievement from a specific user — the inverse of grant.
Inferred read-onlyamba_challenges_getFetch a single challenge by ID, including timing, goal, and reward configuration.
Inferred read-onlyamba_get_challengeFetch a single challenge by ID, including timing, goal, and reward configuration.
Inferred read-onlyamba_challenges_list_participantsList participants of a challenge with their progress toward the goal.
Inferred read-onlyamba_list_challenge_participantsList participants of a challenge with their progress toward the goal.
Inferred read-onlyamba_currency_grant_rules_createCreate a rule that automatically grants virtual currency when a specific event is tracked.
Potential side effectsamba_catalog_listList all catalog items for a project, optionally filtered by category.
Inferred read-onlyamba_list_catalogList all catalog items for a project, optionally filtered by category.
Inferred read-onlyamba_catalog_items_set_priceSet the price of a catalog item in a specific virtual currency.
Inferred read-onlyamba_set_item_priceSet the price of a catalog item in a specific virtual currency.
Inferred read-onlyamba_stores_add_listingAdd a catalog item to a store with optional price overrides, scheduling, and purchase limits.
Potential side effectsamba_add_store_listingAdd a catalog item to a store with optional price overrides, scheduling, and purchase limits.
Potential side effectsamba_inventory_revoke_itemRemove a catalog item from a user's inventory — the inverse of grant.
Potential side effectsamba_entitlements_grantGrant or refresh a subscription entitlement directly on a user — the same `user_entitlements` row mobile store webhooks (Apple/Play) write to, so a server-side grant and an in-app purchase land in one unified place your client SDK reads with `Amba.entitlements`.
Potential side effectsamba_entitlements_defineDefine a canonical entitlement your app gates features on with `Amba.entitlements.has("pro")`.
Inferred read-onlyamba_products_createDeclare a sellable subscription product and the entitlement it grants.
Inferred read-onlyamba_entitlements_map_productMap a product to an (additional) entitlement it unlocks.
Inferred read-onlyamba_offerings_createCreate (or replace) a subscription offering — the named set of packages your paywall renders, fetched at runtime with `Amba.offerings()`.
Potential side effectsamba_offerings_listList the project's subscription offerings with their packages and the product behind each — the same provider-neutral shape the client SDK's `offerings()` returns.
Inferred read-onlyamba_users_get_inventoryView a user's inventory including all owned items and quantities.
Inferred read-onlyamba_get_user_inventoryView a user's inventory including all owned items and quantities.
Inferred read-onlyamba_referrals_createCreate a referral/promo code with configurable rewards for both referrer and referee.
Potential side effectsamba_create_referral_programCreate a referral/promo code with configurable rewards for both referrer and referee.
Potential side effectsamba_referrals_get_statsGet stats for a specific referral code including total claims and claim history.
Inferred read-onlyamba_get_referral_statsGet stats for a specific referral code including total claims and claim history.
Inferred read-onlyamba_stores_list_listingsList all listings in a store, including the underlying catalog item details, ordered by sort_order.
Inferred read-onlyamba_stores_patch_listingUpdate a store listing (price overrides, sort order, availability window, purchase caps).
Potential side effectsamba_catalog_items_getFetch a single catalog item by ID, including its prices and any bundled content.
Inferred read-onlyamba_get_catalog_itemFetch a single catalog item by ID, including its prices and any bundled content.
Inferred read-onlyamba_catalog_items_delete_priceRemove a single currency price from a catalog item.
Potential side effectsamba_catalog_bundles_remove_itemRemove a content item from a catalog item's bundle.
Potential side effectsamba_remove_catalog_bundle_itemRemove a content item from a catalog item's bundle.
Potential side effectsamba_currencies_get_transactionsList currency transactions for a single user, newest first.
Inferred read-onlyamba_get_currency_transactionsList currency transactions for a single user, newest first.
Inferred read-onlyamba_currencies_get_user_balanceRead a user's current per-currency balances directly — the live value your client SDK and paywall logic see, returned in one call instead of replaying and summing the transaction ledger.
Inferred read-onlyamba_monetization_planPreview the monetization plan for a project: a three-way diff between the declared subscription config (entitlements, products, offerings, packages, paywalls), the last-adopted baseline, and the live config in the connected provider (RevenueCat).
Inferred read-onlyamba_monetization_driftShow only the out-of-band drift for a project's monetization: Amba-managed subscription objects whose live state in the provider (RevenueCat) has changed since Amba last adopted them.
Inferred read-onlyamba_monetization_exportSnapshot a project's LIVE subscription monetization config (from the connected provider, RevenueCat) into a declarative bundle: entitlements, products, offerings, packages, and paywalls keyed by their stable identifiers.
Inferred read-onlyamba_monetization_definitions_listList the project's current DECLARED monetization definitions (the desired-state entitlements, products, offerings, packages, and paywalls stored in Amba).
Inferred read-onlyamba_monetization_applyApply the declared monetization config to the connected provider (RevenueCat).
Inferred read-onlyamba_monetization_adoptAdopt a project's live subscription config as Amba's managed baseline: writes the matching declared definitions AND records the current live state as the adopted baseline, so the NEXT plan is a clean no-op and future provider-side edits surface as drift.
Inferred read-onlyamba_leaderboards_get_definitionFetch a single leaderboard definition by ID — its metric, period, and configuration.
Inferred read-onlyamba_get_leaderboard_definitionFetch a single leaderboard definition by ID — its metric, period, and configuration.
Inferred read-onlyamba_leagues_list_cohortsList this week's active cohorts for a league, each with a member_count.
Inferred read-onlyamba_list_league_cohortsList this week's active cohorts for a league, each with a member_count.
Inferred read-onlyamba_onboarding_getGet a single onboarding flow by id including its ordered steps.
Inferred read-onlyamba_tracked_links_get_statsGet click analytics for a tracked link including total clicks, unique users, and clicks by platform.
Inferred read-onlyamba_get_link_statsGet click analytics for a tracked link including total clicks, unique users, and clicks by platform.
Inferred read-onlyamba_deeplinks_get_configGet the deep-link configuration (URL scheme, universal link domain, iOS/Android identifiers, fallback URL) for a project.
Inferred read-onlyamba_deeplinks_set_configUpsert the deep-link configuration (URL scheme, universal link domain, iOS/Android identifiers, fallback URL) for a project.
Inferred read-onlyamba_media_catalogs_createCreate a curated media catalog — a named, slug-addressable bundle of media assets your app fetches in one call.
Potential side effectsamba_media_catalogs_listList media catalogs for a project, each with its item count.
Inferred read-onlyamba_media_catalogs_getGet a single media catalog and its ordered items, each resolved to a stable public asset URL.
Inferred read-onlyamba_media_catalogs_updateUpdate a media catalog's name, slug, description, visibility, or metadata.
Potential side effectsamba_moderation_queue_listList moderation queue items for a project, filtered by status.
Inferred read-onlyamba_messaging_add_participantAdd a user to an existing conversation (idempotent).
Inferred read-onlyamba_messaging_remove_participantRemove a user from a conversation (idempotent inverse of add).
Potential side effectsamba_messaging_list_conversationsList message conversations for a project, newest first.
Potential side effectsamba_messaging_list_messagesList messages within a single conversation, ordered by send time.
Potential side effectsamba_feeds_list_rulesList all feed generation rules for a project, ordered by source_event.
Inferred read-onlyamba_reviews_list_itemsList reviewable items for a project, ordered by average rating.
Inferred read-onlyamba_groups_list_membersList members of a single group, with their join timestamps and roles.
Inferred read-onlyamba_list_group_membersList members of a single group, with their join timestamps and roles.
Inferred read-onlyamba_xp_rules_createCreate an XP rule that auto-awards XP when a matching engagement event is tracked.
Potential side effectsamba_create_xp_ruleCreate an XP rule that auto-awards XP when a matching engagement event is tracked.
Potential side effectsamba_xp_grantDirectly add XP to a user's total — for rewards, promos, or support corrections.
Inferred read-onlyamba_events_listList engagement events for a project (most recent first) with cursor pagination on (occurred_at, id).
Inferred read-onlyamba_events_explainDry-run an event against the rule engine: given a candidate event (name + properties + optional user), return which rules WOULD match and what each WOULD produce — XP awards, currency grants, feed items, streak qualification, and webhook deliveries — WITHOUT firing the event or committing any side effect.
Inferred read-onlyamba_events_trackTrack an engagement event on behalf of a user from the server side — the one call that drives the whole reactive pipeline: streak qualification, currency grant rules, XP awards, achievements, segment membership, and any webhooks subscribed to the event all fan out from this single write.
Potential side effectsamba_events_catalogDiscover every event you can subscribe a webhook to — both APP events (inside your app: users, gamification, economy, social, content) and CONTROL-plane lifecycle events (about the project itself: provisioning, deploys, domains, billing).
Inferred read-onlyamba_control_webhooks_createSubscribe a webhook to CONTROL-plane lifecycle events for this project — provisioning, deploys, domains, billing.
Inferred read-onlyamba_control_webhooks_listList this project's control-plane webhook subscriptions (most recent first).
Inferred read-onlyamba_control_webhooks_deleteDelete a control-plane webhook subscription by id.
Potential side effectsamba_funnels_getGet a single funnel definition by id (name, ordered steps, conversion window).
Inferred read-onlyamba_funnels_updateUpdate a funnel's name, description, steps, and/or conversion window.
Potential side effectsamba_funnels_queryCompute a funnel: per-step distinct-user counts, conversion rates, and drop-off over an entry date range.
Potential side effectsamba_collections_createCreate a new collection (schema-first Postgres table) in a project.
Potential side effectsamba_create_collectionCreate a new collection (schema-first Postgres table) in a project.
Potential side effectsamba_collections_listList every collection in a project (customer-facing names, with creation/change timestamps).
Inferred read-onlyamba_list_collectionsList every collection in a project (customer-facing names, with creation/change timestamps).
Inferred read-onlyamba_collections_getDescribe one collection: live column list + indexes (read from information_schema/pg_indexes) plus the latest collection-migration record.
Inferred read-onlyamba_get_collectionDescribe one collection: live column list + indexes (read from information_schema/pg_indexes) plus the latest collection-migration record.
Inferred read-onlyamba_collections_reset_dataReset a collection: empty ALL of its rows in one call WITHOUT dropping the collection — the schema, columns and indexes survive, only the data is cleared.
Inferred read-onlyamba_collections_alterAlter a collection: exactly one of `add_column`, `add_index`, `change_type`, `rename_column`, `drop_column`, `relax_user_id`, or `set_policy` per call (the underlying saga is built around one SQL blob per workflow; set_policy is a metadata-only write applied without the saga).
Potential side effectsamba_alter_collectionAlter a collection: exactly one of `add_column`, `add_index`, `change_type`, `rename_column`, `drop_column`, `relax_user_id`, or `set_policy` per call (the underlying saga is built around one SQL blob per workflow; set_policy is a metadata-only write applied without the saga).
Potential side effectsamba_admin_insert_rowInsert a row directly into a collection from the developer/agent side — BYPASSES auto-RLS.
Potential side effectsamba_admin_insert_rowsBulk-insert up to 500 rows into a collection in a single atomic statement — BYPASSES auto-RLS.
Potential side effectsamba_admin_aggregate_rowsRun a group-by aggregation over a collection from the admin side — BYPASSES auto-RLS.
Inferred read-onlyamba_admin_update_rowUpdate a single row by id from the developer/agent side — BYPASSES the per-user row scoping the client tools enforce, so it can edit ANY row regardless of which app_user owns it.
Potential side effectsamba_admin_delete_rowDelete a single row by id from the developer/agent side — BYPASSES the per-user row scoping the client tools enforce, so it can delete ANY row regardless of which app_user owns it.
Potential side effectsamba_admin_bulk_updateUpdate EVERY row matching a `where` filter in one statement, from the developer/agent side — BYPASSES the per-user row scoping the client tools enforce (updates rows across all app_users).
Potential side effectsamba_admin_bulk_deleteDelete EVERY row matching a `where` filter in one statement, from the developer/agent side — BYPASSES the per-user row scoping the client tools enforce (deletes rows across all app_users).
Potential side effectsamba_client_insert_rowInsert a row into a collection as the signed-in app_user.
Potential side effectsamba_client_get_rowFetch a single row by id, scoped to the signed-in app_user (auto-RLS).
Inferred read-onlyamba_client_count_rowsCount rows matching an optional where-clause, scoped to the signed-in app_user.
Inferred read-onlyamba_client_find_nearest_rowsVector similarity search against a `vector`-typed column.
Inferred read-onlyamba_client_aggregate_rowsRun a group-by aggregation over a collection as the signed-in app_user — server-side, no rows shipped to the client.
Inferred read-onlyamba_functions_deleteDelete a function and cascade cleanup: the dispatch-namespace script is removed and every active deployment row for the function is marked disabled.
Potential side effectsamba_delete_functionDelete a function and cascade cleanup: the dispatch-namespace script is removed and every active deployment row for the function is marked disabled.
Potential side effectsamba_functions_get_logsRead function logs for one function over a bounded time range.
Inferred read-onlyamba_get_function_logsRead function logs for one function over a bounded time range.
Inferred read-onlyamba_sites_getDescribe one site by name, including its attached custom domains (with cert lifecycle status).
Inferred read-onlyamba_get_siteDescribe one site by name, including its attached custom domains (with cert lifecycle status).
Inferred read-onlyamba_sites_list_domainsList custom hostnames attached to a site, with their cert lifecycle status.
Inferred read-onlyamba_list_site_domainsList custom hostnames attached to a site, with their cert lifecycle status.
Inferred read-onlyamba_domains_checkCheck authoritative availability + price for specific domains (up to 20 at once).
Inferred read-onlyamba_domains_purchaseBuy a domain through Amba and connect it to one of the project's sites as a live custom domain — the customer never touches DNS.
Inferred read-onlyamba_domains_listList domains this project has purchased through Amba, with registration status and the site each is connected to.
Inferred read-onlyamba_operations_getPoll an async operation by its operation_id to see whether it has finished.
Inferred read-onlyamba_secrets_getLook up one secret's metadata (version, sync_status, attempts, last_error).
Inferred read-onlyamba_get_secretLook up one secret's metadata (version, sync_status, attempts, last_error).
Inferred read-onlyamba_ai_prompts_listList every registered AI prompt on a project (name, version, provider, model, system_prompt, max_tokens, rate_limit, client_invokable, timestamps).
Inferred read-onlyamba_list_ai_promptsList every registered AI prompt on a project (name, version, provider, model, system_prompt, max_tokens, rate_limit, client_invokable, timestamps).
Inferred read-onlyamba_ai_prompts_get_spendRead a prompt's AI spend for the current budget period, alongside its budget (if any).
Inferred read-onlyamba_ai_providers_setRegister or rotate the upstream AI provider API key for a project.
Inferred read-onlyamba_experiments_createCreate an A/B experiment: a stable `key`, a display `name`, and >= 2 weighted variants.
Potential side effectsamba_experiments_listList every experiment on a project (key, name, variants, status, timestamps), ordered by key.
Inferred read-onlyamba_experiments_getGet a single experiment by key (name, variants, status, timestamps).
Inferred read-onlyamba_experiments_updateUpdate an experiment's name, description, variants, and/or status.
Potential side effectsamba_experiments_resultsCompute per-variant results for an experiment: assigned_count, exposed_count, and (when `conversion_event` is supplied) converted_count + conversion_rate — the distinct exposed users who emitted that analytics event at/after their assignment.
Inferred read-onlyamba_project_exportExport a declarative bundle of a project's reusable configuration so it can be re-created in another project (e.g.
Inferred read-onlyamba_project_importImport a declarative configuration bundle (from `amba_project_export`) into a project.
Inferred read-onlyamba_billing_statusGet the current billing tier, current-period usage by meter (MAU, events, push, db_storage, media_storage, agent tool calls) with per-meter cost, the billing period and its reset date, spend ceiling + percent consumed, a projected end-of-period overage, the live enforcement state (whether the project is in read-only mode — metered writes returning 402 — and which meters are over quota), and what (if any) human action is required before the agent can continue safely.
Inferred read-onlyamba_billing_tiersReturns the full Amba tier catalog as structured JSON — tier names, prices, included quotas, overage rates, and the feature differences between tiers.
Inferred read-onlyamba_billing_set_ceilingSet or remove the monthly spend ceiling for a project.
Potential side effectsamba_payments_account_createCreate the project's connected payments account so the app can accept payments from its users (the app is the seller; Amba takes a platform fee, Stripe carries the money).
Potential side effectsamba_payments_create_onboarding_linkGenerate a hosted onboarding URL the seller opens to finish setting up payments (identity, bank details — handled entirely by the payment provider, Amba never sees identity documents).
Potential side effectsamba_payments_account_statusRead the connected payments account status — onboarding stage, whether charges and payouts are enabled, and the configured default platform fee.
Inferred read-onlyamba_payments_set_feeSet the default platform fee taken on each payment, in basis points (e.g.
Potential side effectsamba_payments_chargeCreate a payment (destination charge) on behalf of the seller, taking the platform fee.
Potential side effectsamba_payments_balanceRead the seller's available and pending payment balance per currency.
Potential side effectsamba_payments_payoutsList the seller's recent payouts (transfers from the payment balance to their bank), with amount, currency, status, and arrival date.
Potential side effectsamba_agent_checkout_enableTurn agent checkout on (or off) for a project, so your users' AI agents can pay inside your app and have entitlements unlock in the same motion.
Potential side effectsamba_agent_checkout_capabilitiesRead which agent-checkout settlement rails a project can offer (and, when a rail is unavailable, exactly why).
Inferred read-onlyamba_projects_invite_memberInvite a teammate by email to collaborate on this project.
Potential side effectsamba_projects_list_membersList all members of a project, including the owner and accepted invitees.
Inferred read-onlyamba_service_accounts_createCreate a scoped service account under an organization.
Potential side effectsamba_webhooks_listList all webhook subscriptions for a project (most recent first).
Inferred read-onlyamba_webhooks_testSend a synthetic test delivery to a subscription to verify receiver setup.
Potential side effectsamba_webhooks_deliveries_listList recent webhook delivery attempts (most recent first).
Inferred read-onlyamba_webhooks_deliveries_getDescribe a single webhook delivery by id, including the full attempt log, attempt count, and last error.
Inferred read-onlyamba_webhooks_deliveries_replayRe-enqueue a terminated (failed or dead-lettered) delivery, rebuilding the original payload from the source event.
Inferred read-onlyamba_email_templates_createCreate or update a transactional email template (upsert keyed by name — re-creating an existing name overwrites it).
Potential side effectsamba_email_templates_listList all transactional email templates for a project, ordered by name.
Potential side effectsamba_email_templates_getGet a single transactional email template by name, including its subject, html_body, and text_body.
Potential side effectsamba_email_suppressions_createAdd an email address to the suppression list (upsert).
Potential side effectsamba_email_suppressions_listList suppressed email addresses (most recent first, up to 500).
Potential side effectsamba_email_suppressions_deleteRemove an email address from the suppression list (operator unblock).
Potential side effectsamba_email_deliveries_listList recent email delivery records (most recent first).
Potential side effectsamba_email_deliveries_getDescribe a single email delivery by id, including recipient, template, status, and last error if it failed.
Potential side effectsamba_app_mcp_get_configRead the configuration of this app's agent surface (the per-app MCP endpoint whose tools are the app's own collections and functions).
Inferred read-onlyamba_app_mcp_set_exposureSet which collections and deployed functions the app agent surface exposes as typed tools.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.amba]
url = "https://mcp.amba.dev/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"amba": {
"type": "http",
"url": "https://mcp.amba.dev/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: amba
Remote MCP URL: https://mcp.amba.dev/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"amba": {
"url": "https://mcp.amba.dev/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"amba": {
"type": "http",
"url": "https://mcp.amba.dev/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "amba",
"transport": "streamable-http",
"url": "https://mcp.amba.dev/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Trust Data Available
BuiltWith Trust API v2 evidence for amba.dev was fetched 2026-08-04T03:22:17.707Z and is being refreshed.
amba.dev is assessed as Trusted: Domain has an established technology history spanning over a year.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.