Adjust

com.getmcpadsPublished by getmcpads.comv1.0.1Updated Nov 2, 2026

Adjust MCP server: 5 read tools, 0 write tools. Read-only reporting for allowlisted apps.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only Adjust reporting MCP server that lets an assistant list allowlisted apps, inspect event catalogs and run attribution and performance reports.

What you can do
  • List allowlisted apps the API token can read, with currency, operating systems and any configured tokens Adjust did not return
  • Discover event slugs, activity-count metric IDs and app-specific event tokens for one app
  • Read the documented dimensions, example metrics and event metrics of one app
  • Run attribution and performance reports for one app with native totals, warnings and measurement settings
  • Compare two equal-length periods for one app using identical settings
When to use it
Useful when you want an assistant to pull Adjust mobile attribution and performance numbers, event definitions or period-over-period comparisons for a fixed set of apps, without giving it any way to change account data.
Requirements
Runs locally over stdio as an npm package, started with Node.js (version 22.23.4, 24.22.1, 26.12.1 or newer on those lines) and an MCP client that supports stdio. Needs an Adjust API token in ADJUST_API_TOKEN and a comma-separated list of app tokens in ADJUST_APP_TOKENS (up to 200). ADJUST_ENVIRONMENT optionally selects production or sandbox. Network access to the Adjust Report Service host is required.
Before you install
ADJUST_API_TOKEN is a bearer credential carrying the owning user's reporting access, so treat it as a secret and update the client configuration when rotating it. Requests go to Adjust's Report Service and are limited to the apps in ADJUST_APP_TOKENS; reports are aggregated only, with no user- or device-level data. The server is read-only and has no write tools, but it does send your reporting queries to Adjust.

Installation

In SourceWeft

  1. Open Adjust in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.1: Zod 4 security update · October 26, 2026

  • Update zod to 4.6.7. Every Zod release before 4.6.6 is covered by the high-severity advisory GHSA-mrhx-c7xc-m3w5: validating an oversized constrained collection can exhaust memory, and no Zod 3 release carries the fix. npm audit --omit=dev reports no vulnerability again.
  • Keep the Zod 3 validation behaviour. A parameter default is still validated and completed before use, so an omitted object must still supply its required fields.
  • Keep each parameter's own description when the parameter is optional or has a default. Zod 4 stores a description on the wrapped schema only, so the shared fallback description could otherwise replace it.
  • Tool names, parameters and descriptions published over MCP are unchanged. server-card.json is regenerated with Zod 4's JSON Schema output, which spells some constraints differently.

Earlier releases

VersionDateHighlights
1.0.0October 23, 2026First 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.

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.

bash
git clone --branch v1.0.1 --depth 1 https://github.com/get-mcp-ads/adjust-mcp-server.gitcd adjust-mcp-servernpm cinpm run build

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

json
{  "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:

VariablePurpose
ADJUST_API_TOKENRequired. The API token of your Adjust user. It is a bearer credential with that user's reporting access.
ADJUST_APP_TOKENSRequired. 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_ENVIRONMENTproduction (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 MCPThis server
AvailabilityEarly Access, added to your Adjust package on requestOpen source under Apache 2.0
ConnectionRemote endpoint https://mcp.adjust.com/mcpoLocal process over stdio
AuthenticationOAuth in supported clientsAdjust API token in an environment variable
DataAggregated data onlyAggregated 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: [email protected].

Development

bash
npm run typechecknpm run lintnpm run buildnpm testnpm 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.

5 read tools
ToolPurpose
adjust_list_appsList the allowlisted apps the API token can read, with native currency, configured operating systems and any configured token Adjust did not return
adjust_list_eventsDiscover event slugs, activity-count metric IDs and app-specific event tokens for one app
adjust_get_catalogRead the 35 documented dimensions, 12 example metrics and the event metrics of one app
adjust_run_reportRun an attribution and performance report for one app, with native totals, warnings and measurement settings
adjust_compare_periodsCompare two equal-length periods for one app with identical settings, using native totals

There are no write tools.

Resource

ResourcePurpose
adjust://guideTool 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 Emmanuel at getmcpads. Questions: [email protected].

Source: README.md at commit 2bdf595

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

2
  1. v1.0.1LatestOct 26, 2026
  2. v1.0.0Oct 23, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts