atlassian-marketplace-mcp

Get Marketplace product listing metadata for one app. Returns `{productId, appKey, developerId, appName, summary, tagLine, images, tags, communityEnabled, developerLinks, thirdPartyIntegrations, state, approvalStatus, approvalDetails, slug, cloudComplianceBoundary, hostingVisibility, marketingLabels…

Update Marketplace product listing metadata. PUBLIC IMPACT: changes appear on the app's marketplace page after approval. PUT semantics — body should be a full listing object.

Marketplace 'request app' / 'approve app' activity, per month. Benchmark-style aggregate (NOT a paginated list): `{total:{name, appRequestsAndApprovalsPerMonth:[{date, appRequests, appRequestsApproved, appRequestsApprovalRate}]}, addons:[{addonKey, name, productId, appRequestsAndApprovalsPerAppPerMo…

Look up app-software (the technical artifact behind a product listing) by its appKey. Returns an ARRAY of `{appSoftwareId, hosting, complianceBoundaries, archived}` — one entry per hosting platform the app supports. `complianceBoundaries` is a Cloud-only concept (an array like `["commercial"]` for c…

List versions for an app-software. Returns `{links, versions:[{buildNumber, versionNumber, compatibilities, supportedPaymentModel, frameworkDetails, licenseType, ...}], totalCount}`. CURSOR-paginated (`limit`+`cursor` from `links.next`) — `offset` is NOT supported (silently ignored).

Create a new version for an app-software. PUBLIC IMPACT (eventually): once a version is approved and listing is published, customers can install it.

Get one version of an app-software by build number.

Update one version of an app-software (PUT — full replace).

List API access tokens minted for this app-software. Returns `{tokens:[{token, cloudId, instance}]}` — each token maps to one Cloud install. CREDENTIAL-ADJACENT: exposes token identifiers + the customer cloud sites they belong to.

Create a new access token for this app-software. CREDENTIAL: the returned token must be stored securely — Atlassian will not show it again.

List version-listings for an app-software (per-version published metadata: screenshots, highlights, moreDetails, youtubeId, developerLinks, approvalStatus, state, buildNumber, revision). Returns `{links, versions:[…]}`. Despite the name, it's CURSOR-paginated (default 10/page; pass `cursor` from `li…

Get the version-listing for a specific build number.

Create a new version-listing for a specific build. PUBLIC IMPACT (after approval): publishes a new app version to the Marketplace.

Update an existing version-listing (PUT — full replace). PUBLIC IMPACT: changes the customer-facing version metadata after approval.

Discover apps in this developer space (live API call). Returns productId (UUID — use as filter), appKey, appName, state. CURSOR-paginated: pass `cursor` (from a prior response's `nextCursor`) to page forward. In summary mode the result includes `nextCursor` (null when no more pages). Default (no `li…

Return the static name -> productId map loaded from PRODUCT_ID_* env vars. Use this to look up product UUIDs by friendly name without an API call.

Have Atlassian fetch an artifact from a public URL and store it. Returns `{fileInfo, _links, details}` — the stored artifact's id/download link live under `_links`/`fileInfo`. NOTE: the API field is `uri` (not `url`); this tool accepts `url` and maps it to `uri` for you.

Get artifact metadata (name, size, content type, download URL).

Sales benchmark vs. ecosystem, per month. Returns `{total:{name, salesBenchmarkPerMonth:[…]}, addons:[{addonKey, name, productId, salesBenchmarkPerMonth}]}`. Each month row: `{date, sale, previousMonthSale, salesMoMGrowth, salesPercentile, salesMoMGrowthBenchmarkAllPartners, salesYTD, salesYTDLastYe…

Evaluations benchmark vs. ecosystem, per month. Returns `{totals:{name, evaluationBenchmarkPerVendorPerMonth:[…]}, addons:[{addonKey, name, productId, evaluationBenchmarkPerAppPerMonth}]}`. NOTE the wrapper is `totals` (plural) and the per-month key differs between total level (`…PerVendorPerMonth`)…

Resolve a developerId from a vendorId (legacy mapping).

Get developer space profile by developerId. Returns `{id, vendorId, name, status, type, organisationId, version}`. Defaults to MARKETPLACE_DEVELOPER_ID. Unknown/malformed id → HTTP 400.

Get the catalog-account ID for a developer space (used by some downstream services).

Get the developer-profile listing documents (developer profile copy, web metadata, etc.). Returns a bare ARRAY of listing objects (not an envelope). NOT the product apps — use apps_list for those.

List team members in the developer space. Returns `{members:[{aaid, roles, categories, email, userName}], next}`. CURSOR-paginated, but with a NON-STANDARD shape (unlike the `links.next` URL used by other list tools): `next` is a BARE opaque cursor token (or absent on the last page) — pass its value…

Get one developer-space team member by Atlassian account id (aaid). Returns `{aaid, roles, categories, email, userName}` — contains PII (email, userName). Unknown aaid → HTTP 400.

Add a user to the developer space. AFFECTS OTHERS: grants console access to this user.

Update a developer-space team member (PUT — full replace).

Remove a user from the developer space. AFFECTS OTHERS: revokes their console access.

Evaluation time-series grouped by a dimension. FLAT `total.series[]` (no datasets, no uniqueTotal) — one series per group value (e.g. country names for `metric=country`), each `{name, elements:[{date,count}]}` — plus per-app `addons[]`. Only aggregation/startDate/endDate filter (productId/hosting/ad…

Raw customer feedback entries (uninstall/disable/unsubscribe events with reasons + free-text messages). Returns `{_links:{self,query,next}, feedback:[{addonKey, addonVersion, applicationKey, applicationVersion, hosting, date, feedbackType, reasonKey, reason, message, fullName, appEntitlementId, appE…

Feedback time-series grouped by a metric. FLAT `total.series[]` (no datasets, no uniqueTotal) — one series per group value, each `{name, elements:[{date,count}]}` — plus per-app `addons[]`. For `metric=reason` series are reasonKeys (bugs, merging, not-meeting-needs, other, project-based, sandbox, us…

Export Cloud free-starter-tier entitlements (free users on your apps) as of a single date. Returns JSON array of `{day, licenseId, appEntitlementId, entitlementNumber, parentEdition, dateOfEvaluation, parentUnitCount, technicalEmail, vendorId, addonName, addonKey, productId}` by default; pass `accep…

List licenses for the developer space (paginated, offset/limit). Use 'text' to find a single license by SEN.

Synchronous export of licenses. `accept=csv` (default) returns a CSV string; `accept=json` returns a JSON array. May 5xx on large ranges — prefer the async variant. Request timeout is bumped to 10 min (overridable via EXPORT_TIMEOUT_MS env).

Start an async license export job. Returns `{export:{id}}` to poll. `accept=csv|json` sets the format the eventual download will produce (the start response itself is always the id envelope).

Poll status of an async license export job.

Download a completed async license export. Returns the JSON array of license records. Request timeout is 10 min (overridable via EXPORT_TIMEOUT_MS env) so multi-MB downloads don't get aborted mid-stream. Only call this after the *_status endpoint reports DONE — otherwise you'll get a 404 'Export is …

Start an async export of marketing-attribution data. Returns `{export:{id}}` — pass that id to `marketing_attribution_export_async_status` then `_download`. Filters: productId/addon/text/startDate/endDate (+ `accept` for the eventual download format). Export is param-deduped: identical params yield …

Poll status of an async marketing-attribution export job. NOTE the generic /async/export/ path (shared, not prefixed).

Download a completed async marketing-attribution export. Returns JSON records. Request timeout is 10 min (overridable via EXPORT_TIMEOUT_MS env). Only call this after the *_status endpoint reports DONE — otherwise you'll get a 404 'Export is being processed'.

Get DC-to-Cloud migration compatibility info for an app. Returns `{developerId, productId, addonKey, addonName, cloudMigrationAssistantCompatibility, migrationPath, isDualLicenseOptedIn}`. NOTE: returns HTTP 404 (surfaced as an error) for apps that have no migration-compatibility record configured —…

Create cloud-migration compatibility info for an app. PUT semantics — body is the full document.

Patch cloud-migration compatibility info (partial update).

List parent software (the Atlassian products your apps target — Jira, Confluence, Bitbucket, etc.). Returns `{links, parentSoftware:[…]}`. CURSOR-paginated (`limit`+`cursor` from `links.next`); the default page returns all ~23 products.

Get one parent software (Atlassian product) by ID (e.g. `jira`, `confluence`). Returns `{id, developerId:'Atlassian', name, hostingOptions:[{hosting}], extensibilityFrameworks, state, revision}`. Nonexistent id → HTTP 404.

List known versions of a parent software (e.g. Jira versions Atlassian has published). CURSOR-paginated (`limit`+`cursor` from `links.next`).

Get a parent-software version by its build number (path `/versions/build/{buildNumber}`). Returns `{buildNumber, versionNumber, hosting:[…], state, revision, createdAt}`. Unknown build → HTTP 404.

Get a parent-software version by its human-readable version number (path `/versions/number/{versionNumber}`, e.g. '11.3.8'). Same record shape as version_by_build (`{buildNumber, versionNumber, hosting, state, revision, createdAt}`). Unknown version → HTTP 404.

Fetch partner-metric time series (POST). The `body` shape is `ReportingMetricTimeSeriesRequestBody`: `{metrics:{metricSets:[…], metricFields:[…]}, dateRange:{startDate, endDate}, granularity:'YEAR'|'MONTH'|'WEEK'|'DAY', attributes?, sortByList?, attributeFilter?}`. IMPORTANT: `metrics` is an OBJECT …

Get privacy & security information for an app (used by enterprise procurement reviewers). Returns `{commonCloud:{dataAccessAndStorage, logDetails, dataResidency, privacy, security, properties, hasRestAPIExtension, supportsConfigurableEgress}}`. `state=live` (default) returns the published version; `…

Create or update the draft privacy-and-security information (not yet public). PUT — full replace.

Delete the draft privacy-and-security info (the currently published version is unaffected).

Publish the current draft privacy-and-security info. PUBLIC IMPACT: this version becomes visible to all Marketplace visitors and procurement reviewers.

Get a presigned S3 URL for the latest public Marketplace app-catalog snapshot. Response shape: {date, presignedUrl, expiresInSeconds}. The presignedUrl points to a LARGE CSV file (~150 MB, Content-Type binary/octet-stream — NOT JSON), one row per published app with columns like: is_beta, summary, ta…

List promotions (paginated). STRONGLY prefer this over promotions_list (the non-paged variant can time out). Returns `{_links, promotions:[…], offset, limit, totalItems, orderBy, nextId, prevId}`. Cloud uses cursor pagination via `nextId`/`prevId` (and `totalItems` is null); Server/DC uses `offset`/…

List ALL promotions in one non-paginated response (legacy). WARNING: on partners with many promotions this endpoint is very slow and can hit the request timeout (60s, then retried) — effectively hanging. Prefer promotions_list_paged in almost all cases; use this only when you truly need every promot…

Create a new promotion. PUBLIC IMPACT: promo code becomes redeemable by customers. Required: name, eligibleApps, expirationDate, hostingType, promotionType, discountType.

Get one promotion by ID. Returns the full promotion object (~21 fields: id, name, eligibleApps, startDate, expirationDate, status, promotionType, discountType, discountPercent, maxUses, used, hostingType, promotionCode, …). GOTCHA: a nonexistent/malformed promotionId returns HTTP 500 (not 404).

Update a promotion (PATCH — only supplied fields change).

Get the status of a promotion (ACTIVE | ENDED_EARLY | EXPIRED).

List single-use codes for a SINGLE_USE_PROMOTION.

Generate a new single-use code for a promotion.

Get one single-use code (including usage info if redeemed).

Delete an unused single-use code.

Get the reporting root — a HAL response that lists all available reporting links for this developer space.

List customer reviews for an app. CURSOR-paginated (not offset). Returns `{productId, reviews:[{id, content, stars, date, totalVotes, helpfulVotes, productHosting, isFlagged, authorName, transitionedToFiveStarRating}], cursor, count, averageStars}` where `count` is the total review count, `averageSt…

Get a single review by ID.

Post or update a vendor response to a review. PUBLIC IMPACT: response is visible to all Marketplace visitors.

Delete the vendor's response to a review. PUBLIC IMPACT: removes a publicly visible response.

Cloud churn TIME-SERIES (not a single rate). Returns `total.datasets` split by billing period (`Monthly`, `Annual`) with two series each: `Customers` (cohort denominator) and `Cancellations` (numerator), plus per-app breakdown in `addons[]`. Caller computes rate = Cancellations / Customers per bucke…

Per-app monthly churn benchmark vs. ecosystem average. Returns `churnBenchmarkPerApp[]` where each entry has `churnBenchmarkPerMonth[]` rows: `{year, month, churnedLicenses, totalLicenses, churnRate, isolatedChurnRate, churnRateBenchmark, isolatedChurnRateBenchmark}`. The `*Benchmark` fields are nor…

Cloud evaluation→paid conversion TIME-SERIES. Shape differs from churn/renewal: `total.series[]` is FLAT (no `datasets[]` billing-period split) with two series — `Evaluations` (denominator) and `Conversions` (numerator) — each a list of `{date, count}` elements. No `uniqueTotal` field. `addons[]` ca…

Cloud renewal TIME-SERIES. `total.datasets[]` split by billing period (`Annual`, `Monthly`) — like churn — with two series each: `Renewal opportunities` (denominator) and `Renewals` (numerator). NOTE: unlike churn, renewal series have NO `uniqueTotal` field (each series is just `{name, elements:[{da…

License-event details underlying a sale metric. Returns `events[]` rows: `{addonKey, addonName, hosting, lastUpdated, eventDate, transactionId, licenseDetails, productId}`. Supports rich filters (addon, hosting, partnerType, text, sortBy, order, offset, limit). Server caps limit at 50.

Export of license-event details for a sale metric. `accept=csv` (default) returns the 17-column CSV (`addonName,addonKey,hosting,lastUpdated,eventDate,transactionId,licenseId,maintenanceStartDate,maintenanceEndDate,monthsValid,appEntitlementId,appEntitlementNumber,cloudId,inGracePeriod,multiInstance…

Top search keywords across all the partner's apps (developer-space wide). Returns `{total:{searchAppearances, topSearchKeyword}, addons:[{addonName, addonKey, productId, leadingSearchKeyword, searchAppearances, elements:[{date,count}]}]}`. Filters: aggregation/startDate/endDate only (pagination/prod…

Export variant of partner-wide search keywords. With `accept=json` (default) returns the data INLINE as `{_links:{self,query,export}, total, addons}` (same payload as `search_keywords_partner`); with `accept=csv` returns a per-app CSV string. ⚠️ The advertised `_links.export` download URLs are BROKE…

Top search keywords for one source. Returns `{details:[{searchKeyword, percentage}]}` (flat keyword share, no time series). Filters: startDate/endDate (no aggregation; pagination ignored).

Export variant of source-filtered search keywords. UNLIKE the partner/by_app exports, this returns the FULL DATA directly as a JSON array of `{searchKeyword, percentage}` rows (up to 500), NOT HAL download links. Large responses spill to the truncation envelope.

Top search keywords for one app. Returns `{summary:{addonName, addonKey, leadingSearchKeyword, …}, details:[{searchKeyword, keywordCount, elements:[{date,count}]}]}`. `productId` is a PATH segment. Filters: aggregation/startDate/endDate (pagination/hosting ignored).

Export variant of per-app search keywords. Returns the data INLINE as `{_links:{self,query,export}, summary, details}` — same payload as `search_keywords_by_app`. ⚠️ The advertised `_links.export` CSV/JSON download URLs are BROKEN (Atlassian-side doubled `/export/export` path → 404, verified 2026-06…

Keywords that produced ZERO search results, for one source — SEO gap analysis. Returns `{details:[{searchKeyword, count}]}` (count = how many times the no-result search happened). Filters: startDate/endDate (no aggregation; pagination ignored).

Export variant of zero-result keywords. Returns the FULL DATA directly as a JSON array of `{searchKeyword, count}` rows (up to 500), NOT HAL download links (same as the by_source export). Large responses spill to the truncation envelope.

List sales transactions for this vendor's apps (refunds appear inline as negative amounts). NOTE per Atlassian: this endpoint can return 5xx on large datasets — for full pulls, prefer transactions_export_async_start + status + download. Use 'text' to find by transactionId, licenseId, SEN, customer i…

Synchronous export of transactions. `accept=csv` (default) returns a CSV string; `accept=json` returns a JSON array. Prefer async for large ranges. Request timeout is 10 min (overridable via EXPORT_TIMEOUT_MS env).

Start an async transactions export job. Returns `{export:{id}}` to poll. `accept=csv|json` sets the eventual download format (start response is always the id envelope).

Poll status of an async transactions export job.

Download a completed async transactions export. Returns the JSON array of transaction records. Request timeout is 10 min (overridable via EXPORT_TIMEOUT_MS env). Only call this after the *_status endpoint reports DONE — otherwise you'll get a 404 'Export is being processed'.

Aggregated sales grouped by a metric path segment. Maps to /sales/transactions/{metric}.

Friendly alias for transactions_aggregate_by_metric(metric='hosting'). HAL template `hosting{?aggregation,startDate,endDate}`. NOTE: `productId` is silently ignored on this specific endpoint (verified 2026-06-03) — use `transactions_aggregate_by_metric` with `metric=hosting` if you need productId sc…