Skip to content
Agentmart
Submit a tool

Amazon Ads MCP

Amazon Ads API MCP server for Amazon Advertising API

Connector by KuudoAI · GitHub account verified by the MCP Registry

IndexedMITRemote (HTTP)★ 74
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/kuudoai-amazon-ads-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://{HOSTNAME}/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Amazon Ads API MCP server for Amazon Advertising API

Use cases: marketing-content, api-integration

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
21 read · 9 write · 2 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 32

Read from the source code; the running server may list different tools.

Read 21 · Look things up without changing anything.

  • _report_fields_debug
  • check_oauth_status
  • get_active_identity
  • get_active_profile
  • get_download_url
  • get_envelope_contract
  • get_region
  • get_routing_state
  • get_session_state
  • list_downloads
  • list_identities
  • list_regions
Show 9 more tools
  • list_report_fields
  • list_tool_groups
  • page_profiles
  • read_download
  • refresh_profiles_cache
  • report_fields
  • search_profiles
  • summarize_profiles
  • test_sampling

Write 9 · Create, change, send or run things.

  • download_export
  • enable_tool_group
  • refresh_oauth_token
  • select_profile
  • set_active_identity
  • set_active_profile
  • set_context
  • set_region
  • start_oauth_flow

Delete 2 · Delete, drop, revoke or wipe things.

  • clear_active_profile
  • clear_oauth_tokens

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization

Network hosts it talks to 18

  • ads.kuudo.com · found in code
  • advertising-api-eu.amazon.com · found in code
  • advertising-api-fe.amazon.com · found in code
  • advertising-api.amazon.com · found in code
  • amazon-spapi-dev.kuudo.ai · found in code
  • amazon.com · found in code
  • api.amazon.co.jp · found in code
  • api.amazon.co.uk · found in code
  • api.amazon.com · found in code
  • app.kuudo.com · found in code
  • authentication.api.openbridge.io · found in code
  • github.com · found in code
  • openbridge.io · found in code
  • remote-identity.api.openbridge.io · found in code
  • sellingpartnerapi-eu.amazon.com · found in code
  • sellingpartnerapi-fe.amazon.com · found in code
  • sellingpartnerapi-na.amazon.com · found in code
  • service.api.openbridge.io · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (32)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • _report_fields_debug

    Internal: return loaded catalog schema_version, parsed_at, entry counts, and source_commit. Hidden unless AMAZON_ADS_DEBUG_TOOLS=true.

  • check_oauth_status

    Check the current OAuth authentication status

  • clear_active_profile

    Description is built at runtime.

  • clear_oauth_tokens

    Clear all stored OAuth tokens and state

  • download_export

    Download a completed export to local storage (supports background execution)

  • enable_tool_group

    Enable or disable an API tool group by prefix. Call list_tool_groups first to see available groups.

  • get_active_identity

    Get the currently active identity. Doubles as a session-scope probe: the response includes `session_present`, `state_scope`, and `state_reason` so agents can detect whether previously-set context survived to this call.

  • get_active_profile

    Get the currently active profile ID. Doubles as a session-scope probe: the response includes `session_present`, `state_scope`, and `state_reason` so agents can detect whether previously-set context survived to this call.

  • get_download_url

    Get the HTTP URL for downloading a file. Use with list_downloads to find available files, then get their download URLs. The URL can be opened in a browser or used with curl/wget to download the file. Note: Requires HTTP transport (not stdio).

  • get_envelope_contract

    Read-only probe: returns the cross-server error envelope contract this server implements (contract_version, error_kinds, normalized_kinds, env_vars). See openbridge-mcp/CONTRACT.md for the canonical specification.

  • get_region

    Get the current region setting

  • get_routing_state

    Get the current routing state (region, host, headers). Doubles as a session-scope probe: the response includes `session_present`, `state_scope`, and `state_reason` so agents can detect whether previously-set context survived to this call.

  • get_session_state

    Read-only probe: returns `{session_present, state_scope, state_reason}` for the current transport. No side effects, no auth/network I/O — call this once at the start of an `execute` block to learn how to manage context. Re-establish context before the next tool call iff `state_scope == 'request'` or `state_reason` is not null. Probe the transport once per block via `get_session_state`; the scope cannot change within a block, so one probe per block is sufficient. `state_reason` is `null` on the happy path. When non-null it takes one of: - `"no_mcp_session"` — the transport has no long-lived M…

  • list_downloads

    List all downloaded exports and reports for the active profile

  • list_identities

    List all available identities

Show 17 more tools
  • list_regions

    List all available regions

  • list_report_fields

    List valid report fields by report operation. Call with no args to list supported operations.

  • list_tool_groups

    List available API tool groups. Groups are disabled by default; use enable_tool_group to activate.

  • page_profiles

    List profiles (paged mode): paginated read with `offset` and `limit`. Returns `{items, total_count, has_more, next_offset}`. Use when iterating across the full set without dumping everything at once.

  • read_download

    Read a profile-scoped downloaded file directly from server storage. Use `list_downloads` to get a `file_path` first.

  • refresh_oauth_token

    Manually refresh the OAuth access token

  • refresh_profiles_cache

    List profiles (cache refresh): force re-fetch of cached profiles for the current identity and region. Use when you suspect cached data is stale before the next summarize/search/page call.

  • report_fields

    Query or validate Ads API v1 report fields against the packaged v1 catalog. Use mode='query' to discover fields (category, search, compatible_with, requires, fields detail lookup with pagination) or mode='validate' to pre-flight a field list before AdsApiv1CreateReport. See list_report_fields for the minimal baseline and other report APIs (rp_*, br_*, mmm_*). Response.stale_warning is a string when the catalog parse timestamp is older than LIST_REPORT_FIELDS_STALE_DAYS (default 90) and null otherwise. Set that env var lower in staging/dev to surface stale-catalog warnings earlier. Optional `dr…

  • search_profiles

    List profiles (search mode): filter by name (`query`), `country_code`, or `account_type`, with bounded `limit`. Use when you know what you're looking for and want a focused result set.

  • select_profile

    Interactively select a profile from available options

  • set_active_identity

    Description is built at runtime.

  • set_active_profile

    Description is built at runtime.

  • set_context

    Description is built at runtime.

  • set_region

    Description is built at runtime.

  • start_oauth_flow

    Start the OAuth authorization flow for Amazon Ads API

  • summarize_profiles

    List profiles (summary mode): aggregate counts by country and account type. Use when you need to know what profile kinds exist without enumerating individual records.

  • test_sampling

    Test LLM sampling functionality via MCP client

Signals

Stars
74
Forks
24
Open issues
0
Contributors
5
Last commit
Oct 14, 2026 (14 days ago)
Last release
Oct 14, 2026 (14 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.KuudoAI/amazon_ads_mcp
Version
0.3.31
Auth
Bearer token
License
MIT
Repository
github.com/KuudoAI/amazon_ads_mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from KuudoAI

Cite this page

Amazon Ads MCP. Agent Mart. https://agentmart.dev/connectors/kuudoai-amazon-ads-mcp (last updated 2026-10-24)