Skip to main content
Glama
Adjust MCP server

Adjust MCP server

by get-mcp-ads

Adjust MCP server

Bring your Adjust reporting into your MCP client.

Read attribution and performance reports, event catalogs and period comparisons for explicitly selected apps.

Release CI License: Apache 2.0 Node

Watch the film · What's new · Install · Tool reference · Try hosted getmcpads

Watch the getmcpads film: every ad account in one conversation with your AI assistant

Play the 45-second film

The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.

5 read tools · 0 write tools. Read-only by design: no setting adds a write tool.

Run locally with your own Adjust API token and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the Adjust Report Service API. For managed connections, including supported ChatGPT setups, use the hosted option.

What's new

v1.0.2: Maintainer metadata update · November 8, 2026

  • List the getmcpads team as maintainer in package.json, the README and SOURCE_SYNC.md.

  • No change to tools, parameters, descriptions or runtime behaviour.

Earlier releases

Version

Date

Highlights

1.0.1

October 26, 2026

Zod 4 security update

1.0.0

October 23, 2026

First standalone release

Full changelog · All releases

Source synchronization: SOURCE_SYNC.md.

Upgrade notes

This is the first release. It requires Node.js 22.23.4, 24.22.1, 26.12.1 or a newer release of those lines, and prints a warning on stderr when started on an older one. Hosted MCP Apps, exports and business reviews are outside this release.

Related MCP server: ga-gsc-analytics

Install this release

This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version; unpinned npx examples later in this document select the version currently available on npm.

git clone --branch v1.0.2 --depth 1 https://github.com/get-mcp-ads/adjust-mcp-server.git
cd adjust-mcp-server
npm ci
npm run build

Configure your MCP client to run node with the absolute path to dist/cli.js and the variables documented below.

{
  "mcpServers": {
    "adjust": {
      "command": "node",
      "args": ["/absolute/path/to/adjust-mcp-server/dist/cli.js"],
      "env": {
        "ADJUST_API_TOKEN": "your-adjust-api-token",
        "ADJUST_APP_TOKENS": "abc123def456,ghi789jkl012"
      }
    }
  }
}

Once the package is on npm, the same entry can use "command": "npx" with "args": ["-y", "@getmcpads/adjust-mcp-server"]. Run npm run doctor in the repository to check the configuration locally. It prints no secret and makes no network request.

Prefer a managed connection? Use Adjust with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.

Configuration

Provide these environment variables through the client's secret configuration:

Variable

Purpose

ADJUST_API_TOKEN

Required. The API token of your Adjust user. It is a bearer credential with that user's reporting access.

ADJUST_APP_TOKENS

Required. Comma-separated app tokens this server may read, up to 200. Every request is checked against this list, and app discovery returns only these apps.

ADJUST_ENVIRONMENT

production (default) or sandbox. Fixed for every report; a tool call cannot change it.

Adjust shows the API token in your profile's account settings. See Adjust's authentication guide. The server checks the configuration at startup and exits with a message that names the variable to fix. That message never contains a token value. After setup, call adjust_list_apps. Its unavailableAppTokens field lists configured app tokens that Adjust did not return for this API token. This package accepts a token from the environment. It runs no OAuth flow and writes nothing to disk. When you rotate the token, update the client configuration and restart the server.

Safety and coverage

Read-only by design. Every request is an HTTP GET to the Report Service. There is no write tool and no environment variable that adds one. The app allowlist is checked before any request is sent. App discovery is filtered to the allowlist, and a report that contains a row from another app is withheld. Requests go only to automate.adjust.com, the host Adjust documents for the Report Service. Redirects are refused and never followed. Each request has a 25 second timeout and a 20 MB response limit. An HTTP 200 response that carries an error body is treated as a failed request and returns no data. A read makes at most three attempts on HTTP 429, 502, 503 and 504, honoring a short Retry-After. A longer delay is returned as retryAfterSeconds instead of waiting. Adjust documents a limit of 50 requests per second per source IP address, with a burst allowance of 100.

Reports keep Adjust's native totals. They are never rebuilt from breakdown rows. A missing value is null, not zero, and ratios such as ROAS stay native fractions. Truncated rows, provider warnings, duplicate breakdown rows and unexpected pagination metadata mark a report partial. The API token is never returned or logged, and it is removed from provider text before that text reaches the model. Event definitions keep only the requested app: other apps' identifiers and SDK event tokens are removed. The Report Service returns aggregated data. This server has no tool for user-level or device-level data.

Coverage is the Report Service JSON report, the app inventory from filters data and the event catalog. CSV, Parquet and pivot report formats are not exposed. Use tools/list or server-card.json for exact schemas and the Report Service API reference for provider details.

Official Adjust MCP server

Adjust offers its own MCP server. The facts below come from Adjust's help center article, read on October 23, 2026.

Adjust MCP

This server

Availability

Early Access, added to your Adjust package on request

Open source under Apache 2.0

Connection

Remote endpoint https://mcp.adjust.com/mcpo

Local process over stdio

Authentication

OAuth in supported clients

Adjust API token in an environment variable

Data

Aggregated data only

Aggregated Report Service data only

This server reads only the apps listed in ADJUST_APP_TOKENS, within the access of the Adjust user who owns the API token.

Hosted option

getmcpads for Adjust manages the hosted connection and app selection. Hosted and source releases can differ. Contact: hello@getmcpads.com.

Development

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

All tests run offline with synthetic responses. No live Adjust account is contacted.

Tools

Every tool is listed below. See server-card.json for complete parameter and output schemas.

Tool

Purpose

adjust_list_apps

List the allowlisted apps the API token can read, with native currency, configured operating systems and any configured token Adjust did not return

adjust_list_events

Discover event slugs, activity-count metric IDs and app-specific event tokens for one app

adjust_get_catalog

Read the 35 documented dimensions, 12 example metrics and the event metrics of one app

adjust_run_report

Run an attribution and performance report for one app, with native totals, warnings and measurement settings

adjust_compare_periods

Compare two equal-length periods for one app with identical settings, using native totals

There are no write tools.

Resource

Resource

Purpose

adjust://guide

Tool order, app scope, measurement settings, rate limits and documentation link

License

Apache License 2.0. See NOTICE.

More from getmcpads

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

Maintained by the getmcpads team at getmcpads. Questions: hello@getmcpads.com.

Available Tools

5 tools
adjust_compare_periodsadjust compare periodsA
Read-onlyIdempotent

Compare two equal-length periods for one allowlisted Adjust application with identical metrics, filters, OS and measurement settings. Defaults to the immediately preceding period. Changes use native totals, never sums of breakdowns. Unavailable or partial values have no calculated change; cohort maturity and reporting delays still apply.

Inputs: endDate (required), appToken (required), startDate (required), limit, +13 more. Returns: result

adjust_get_catalogadjust get catalogA
Read-onlyIdempotent

Read documented standard Adjust dimensions and example metrics, plus event metrics scoped to one allowlisted application. Metrics and spend/revenue access remain subject to Adjust permissions; the standard metric list is not exhaustive.

Inputs: appToken (required). Returns: result

adjust_list_appsadjust list appsA
Read-onlyIdempotent

List the Adjust applications in ADJUST_APP_TOKENS that this API token can read, with native currency and configured operating systems. Applications outside the allowlist are never returned.

Inputs: no named parameters. Returns: result

adjust_list_eventsadjust list eventsA
Read-onlyIdempotent

Discover native event base slugs, ordinary activity-count metric IDs and app-specific event tokens for one allowlisted Adjust app. Use activityMetric for counts; the event base slug alone is not a report metric. Keep SKAdNetwork and aggregate revenue definitions separate.

Inputs: appToken (required), search. Returns: result

adjust_run_reportadjust run reportB
Read-onlyIdempotent

Read an attribution/performance report for one allowlisted Adjust app. Preserves native totals, warnings, attribution options, currency and UTC offset. Missing metrics are null; ratios are native fractions. A truncated or partial result is not a complete extraction.

Inputs: endDate (required), appToken (required), startDate (required), limit, +12 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation4/5

    adjust_list_events and adjust_get_catalog both expose metric/event metadata, so there is slight overlap, but each has a clear scope: per-app events versus standard dimensions/metrics. adjust_run_report and adjust_compare_periods are clearly separated by single-period reporting versus two-period comparison.

    Naming Consistency5/5

    All five tools use the same adjust_ prefix and a consistent verb_noun pattern: list_apps, list_events, get_catalog, run_report, compare_periods. There is no mixing of casing or verb styles.

    Tool Count5/5

    Five tools is lean but appropriate for a read-only reporting integration: app discovery, event discovery, catalog lookup, report execution, and period comparison. Each tool has a distinct role and none feels redundant.

    Completeness4/5

    The set covers the core read-only workflows: discovering apps, discovering events and metrics, reading catalog metadata, running reports, and comparing periods. Minor gaps may exist around saved reports or broader filter/dimension enumeration, but the surface is largely complete for reporting.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables read-only access to Google Analytics 4 and Google Search Console data, allowing users to run reports, query search analytics, and generate combined snapshots for reporting.
      -
    • F
      license
      A
      quality
      C
      maintenance
      Enables AI clients to read Google Ads account data through reporting tools for campaigns, ad groups, keywords, and raw GAQL queries, with no write or mutate capabilities.
      7
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only access to Addepar portfolio and ownership data for financial reporting, with transparent provenance caveats and compliance-oriented audit logging.
      -