Agent Central API

openapi: 3.1.0
info:
  title: Agent Central API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 22 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Agent Central has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 18
    pages-with-code: 2
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://agentcentral.to/docs/reference/ads
  - https://agentcentral.to/docs/rest-api
  - https://agentcentral.to/docs/quickstart/chatgpt
servers:
- url: https://mcp.agentcentral.to
paths:
  /sd/adGroups:
    post:
      operationId: post_sd_adGroups
      tags:
      - Sd
      summary: Create Sponsored Display ad groups after the caller has selected a campaign ID, name, default bid, and initial state.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
        description: Amazon Ads profile ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSdAdgroupsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_sd_adGroups
      tags:
      - Sd
      summary: Change default bids for existing Sponsored Display ad groups selected by ID.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSdAdgroupsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/adGroups/{adgroupid}:
    delete:
      operationId: delete_sd_adGroups_adgroupid
      tags:
      - Sd
      summary: Submit Sponsored Display ad group archives after the caller has selected SD ad group IDs and explicitly acknowledged the irreversible
        archive operation.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: adgroupid
        in: path
        required: true
        schema:
          type: string
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/campaigns:
    post:
      operationId: post_sd_campaigns
      tags:
      - Sd
      summary: Create Sponsored Display campaign shells after the caller has selected names, tactic, start date, budget, cost type, and initial
        state.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
        description: Amazon Ads profile ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSdCampaignsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_sd_campaigns
      tags:
      - Sd
      summary: Change daily budgets for existing Sponsored Display campaigns selected by ID.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
        description: Amazon Ads profile ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSdCampaignsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/campaigns/{campaignid}:
    delete:
      operationId: delete_sd_campaigns_campaignid
      tags:
      - Sd
      summary: Submit Sponsored Display campaign archives after the caller has selected SD campaign IDs and explicitly acknowledged the irreversible
        archive operation.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: campaignid
        in: path
        required: true
        schema:
          type: string
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
        description: Amazon Ads profile ID.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/negativeTargets:
    post:
      operationId: post_sd_negativeTargets
      tags:
      - Sd
      summary: Preview or submit Sponsored Display negative target creation through Amazon's documented POST /sd/negativeTargets endpoint.
      x-source: https://agentcentral.to/docs/reference/ads
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSdNegativetargetsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_sd_negativeTargets
      tags:
      - Sd
      summary: Preview or submit reversible Sponsored Display negative target state updates through Amazon's documented PUT /sd/negativeTargets
        endpoint.
      x-source: https://agentcentral.to/docs/reference/ads
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSdNegativetargetsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/negativeTargets/{negativetargetid}:
    delete:
      operationId: delete_sd_negativeTargets_negativetargetid
      tags:
      - Sd
      summary: Preview or submit irreversible Sponsored Display negative target archives through Amazon's documented DELETE /sd/negativeTargets/{negativeTargetId}
        endpoint.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: negativetargetid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/productAds:
    post:
      operationId: post_sd_productAds
      tags:
      - Sd
      summary: Create Sponsored Display product ads after the caller has selected campaign, ad group, SKU or ASIN, and initial state.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSdProductadsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_sd_productAds
      tags:
      - Sd
      summary: Pause or re‑enable Sponsored Display product ads without archiving them.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSdProductadsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/productAds/{adid}:
    delete:
      operationId: delete_sd_productAds_adid
      tags:
      - Sd
      summary: Submit Sponsored Display product ad archives after the caller has selected SD ad IDs and explicitly acknowledged the irreversible
        archive operation.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: adid
        in: path
        required: true
        schema:
          type: string
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/targets:
    post:
      operationId: post_sd_targets
      tags:
      - Sd
      summary: Create Sponsored Display targeting clauses after the caller has selected an ad group, expression type, expression predicates, optional
        bid, and initial state.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSdTargetsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_sd_targets
      tags:
      - Sd
      summary: Submit Sponsored Display target bid changes after the caller has selected exact SD target IDs and bid values.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutSdTargetsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sd/targets/{targetid}:
    delete:
      operationId: delete_sd_targets_targetid
      tags:
      - Sd
      summary: Submit Sponsored Display target archives after the caller has selected SD target IDs and explicitly acknowledged the irreversible
        archive operation.
      x-source: https://agentcentral.to/docs/reference/ads
      parameters:
      - name: targetid
        in: path
        required: true
        schema:
          type: string
      - name: profile_id
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/account:
    get:
      operationId: get_v1_account
      tags:
      - Account
      summary: GET /v1/account
      x-source: https://agentcentral.to/docs/rest-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AccountResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://mcp.agentcentral.to/v1/account\"  -H \"Authorization: Bearer ac_live_...\" A successful response for a key with\
          \ Amazon writes disabled: {\n \"data\": {\n \"api_version\": \"v1\",\n \"tenant_id\": \"tenant_8f2c\",\n \"key_prefix\": \"ac_live_a1b2c3d4\"\
          ,\n \"key_scope\": \"marketplace\",\n \"status\": \"active\",\n \"marketplace_id\": \"ATVPDKIKX0DER\",\n \"connection_id\": \"conn_3a91\"\
          ,\n \"reporting_time_zone\": \"America/Los_"
  /v1/ads/search-terms:
    get:
      operationId: get_v1_ads_search_terms
      tags:
      - Ads
      summary: Customer search terms that triggered Sponsored Products or Sponsored Brands ads, with derived ACOS, ROAS, CTR, CPC, and CVR.
      x-source: https://agentcentral.to/docs/rest-api
      parameters:
      - name: ad_product
        in: query
        required: true
        schema:
          type: string
        description: Ad product type (e.g., SP)
      - name: sort_by
        in: query
        required: false
        schema:
          type: string
        description: Column to sort by
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of rows to return
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Offset for pagination
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1AdsSearchTermsResponse'
      x-evidence:
        kind: documentation
  /v1/catalog/listing-changes:
    get:
      operationId: get_v1_catalog_listing_changes
      tags:
      - Catalog
      summary: For retained history, use /v1/catalog/listing-changes. It compares the two latest stored snapshots in the requested window, then
        returns one row per changed field.
      x-source: https://agentcentral.to/docs/rest-api
      parameters:
      - name: asin
        in: query
        required: true
        schema:
          type: string
        description: ASIN to query
      - name: field
        in: query
        required: true
        schema:
          type: string
        description: Comma‑separated list of fields to monitor
      - name: lookback_days
        in: query
        required: true
        schema:
          type: integer
        description: Number of days to look back
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CatalogListingChangesResponse'
      x-evidence:
        kind: documentation
  /v1/catalog/listing-state:
    get:
      operationId: get_v1_catalog_listing_state
      tags:
      - Catalog
      summary: To monitor listing state, request up to 20 seller SKUs per call.
      x-source: https://agentcentral.to/docs/rest-api
      parameters:
      - name: skus
        in: query
        required: true
        schema:
          type: string
        description: Comma‑separated list of seller SKUs (max 20)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1CatalogListingStateResponse'
      x-evidence:
        kind: documentation
  /v1/finance/payment-transactions:
    get:
      operationId: get_v1_finance_payment_transactions
      tags:
      - Finance
      summary: GET /v1/finance/payment-transactions
      x-source: https://agentcentral.to/docs/rest-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -G "https://mcp.agentcentral.to/v1/finance/payment-transactions" -H "Authorization: Bearer ac_live_..." --data-urlencode
          "view=summary" --data-urlencode "start_date=2026-08-11" --data-urlencode "end_date=2026-08-18" --data-urlencode "max_pages=1" Payment
          balances and summaries Use the same payment-transactions endpoint with view=balances for current available, reserved, deferred and total
          fun'
  /v1/responses:
    post:
      operationId: post_v1_responses
      tags:
      - Responses
      summary: POST /v1/responses
      x-source: https://agentcentral.to/docs/quickstart/chatgpt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ResponsesRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ResponsesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.openai.com/v1/responses  -H \"Content-Type: application/json\"  -H \"Authorization: Bearer $OPENAI_API_KEY\"\
          \  -d '{\n \"model\": \"gpt-5\",\n \"tools\": [\n {\n \"type\": \"mcp\",\n \"server_label\": \"agent-central\",\n \"server_url\": \"\
          https://mcp.agentcentral.to/mcp\",\n \"server_description\": \"Amazon seller data: advertising, inventory, rankings, and more\",\n \"\
          headers\": {\n \"Authorization\": \"Bearer YOUR_AGE"
  /v1/skus/performance:
    get:
      operationId: get_v1_skus_performance
      tags:
      - Skus
      summary: GET /v1/skus/performance
      x-source: https://agentcentral.to/docs/rest-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -G "https://mcp.agentcentral.to/v1/skus/performance"  -H "Authorization: Bearer ac_live_..."  --data-urlencode "sort_by=ad_spend"  --data-urlencode
          "limit=50"  --data-urlencode "offset=50" Live reads that page through Amazon use opaque continuation tokens instead of offsets. Pass
          max_pages to bound how many Seller Central pages to fetch (1–5; the default is 1). Each response returns the next '
components:
  schemas:
    PostSdAdgroupsRequest:
      type: object
      properties:
        ad_groups:
          type: array
          description: Sponsored Display ad groups to create (1-100 per call). Each item has campaign_id, name, default_bid, state, and optional
            bid_optimization.
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - ad_groups
    PutSdAdgroupsRequest:
      type: object
      properties:
        updates:
          type: array
          description: Sponsored Display ad group bid updates (1-100 per call). Each item has ad_group_id and default_bid.
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - updates
    PostSdCampaignsRequest:
      type: object
      properties:
        campaigns:
          type: array
          description: Sponsored Display campaigns to create (1-100 per call). Each item includes name, tactic, start_date, budget, cost_type,
            state, and optional end_date or portfolio_id.
        confirm:
          type: boolean
          description: Preview by default. Set true to submit the Ads API mutation.
        idempotency_key:
          type: string
          description: Required when confirm=true. Reusing the same key blocks duplicate Ads API submissions.
        reason:
          type: string
          description: Optional user‑supplied reason for the write, stored where audit logging supports it.
        actor:
          type: string
          description: Optional external actor label for the agent or workflow requesting the write.
      required:
      - campaigns
    PutSdCampaignsRequest:
      type: object
      properties:
        updates:
          type: array
          description: Sponsored Display campaign budget updates (1-100 per call). Each item has campaign_id and budget.
        confirm:
          type: boolean
          description: Preview by default. Set true to submit the Ads API mutation.
        idempotency_key:
          type: string
          description: Required when confirm=true.
        reason:
          type: string
        actor:
          type: string
      required:
      - updates
    PostSdNegativetargetsRequest:
      type: object
      properties:
        profile_id:
          type: string
          description: Amazon Ads profile ID.
        negative_targets:
          type: array
          description: Sponsored Display negative targets to create (1-100 per call). Each item has ad_group_id, expression_type, expressions,
            and state.
        confirm:
          type: boolean
          description: Preview by default. Set true to submit the Ads API mutation.
        idempotency_key:
          type: string
          description: Required when confirm=true. Reusing the same key blocks duplicate Ads API submissions.
        reason:
          type: string
          description: Optional user‑supplied reason for the write, stored where audit logging supports it.
        actor:
          type: string
          description: Optional external actor label for the agent or workflow requesting the write.
      required:
      - profile_id
      - negative_targets
    PutSdNegativetargetsRequest:
      type: object
      properties:
        profile_id:
          type: string
          description: Amazon Ads profile ID.
        updates:
          type: array
          description: Sponsored Display negative target state updates (1-100 per call). Each item has negative_target_id and state (enabled or
            paused).
        confirm:
          type: boolean
          description: Preview by default. Set true to submit the Ads API mutation.
        idempotency_key:
          type: string
          description: Required when confirm=true. Reusing the same key blocks duplicate Ads API submissions.
        reason:
          type: string
          description: Optional user‑supplied reason for the write, stored where audit logging supports it.
        actor:
          type: string
          description: Optional external actor label for the agent or workflow requesting the write.
      required:
      - profile_id
      - updates
    PostSdProductadsRequest:
      type: object
      properties:
        product_ads:
          type: array
          description: Sponsored Display product ads to create (1-100 per call). Each item has campaign_id, ad_group_id, exactly one of sku or
            asin, and state.
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - product_ads
    PutSdProductadsRequest:
      type: object
      properties:
        updates:
          type: array
          description: Sponsored Display product ad state updates (1-100 per call). Each item has ad_id and state (enabled or paused).
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - updates
    PostSdTargetsRequest:
      type: object
      properties:
        targets:
          type: array
          description: Sponsored Display targets to create (1-100 per call). Each item has ad_group_id, expression_type, expressions, optional
            bid, and state.
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - targets
    PutSdTargetsRequest:
      type: object
      properties:
        updates:
          type: array
          description: Sponsored Display target bid updates (1-100 per call). Each item has target_id and bid.
        confirm:
          type: boolean
        idempotency_key:
          type: string
        reason:
          type: string
        actor:
          type: string
      required:
      - updates
    GetV1AccountResponse:
      type: object
      properties:
        api_version:
          type: string
        tenant_id:
          type: string
        key_prefix:
          type: string
        key_scope:
          type: string
        status:
          type: string
        marketplace_id:
          type: string
        connection_id:
          type: string
        reporting_time_zone:
          type: string
        enabled_domains:
          type: array
          items:
            type: string
        permissions:
          type: array
          items:
            type: string
        permissions_semantics:
          type: string
        tool_access:
          type: object
          properties:
            basis:
              type: string
            amazon_writes_enabled:
              type: boolean
            enabled_write_tools:
              type: array
              items: {}
            enabled_state_side_effect_tools:
              type: array
              items:
                type: string
        ads_profile_ids:
          type: array
          items:
            type: integer
        max_exposure_lookback_days:
          type:
          - string
          - 'null'
        connections:
          type: object
          properties:
            amazon_ads:
              type: object
              properties:
                connected:
                  type: boolean
                connected_at:
                  type: string
                  format: date-time
            seller_central:
              type: object
              properties:
                connected:
                  type: boolean
                connected_at:
                  type: string
                  format: date-time
    GetV1AdsSearchTermsResponse:
      type: object
      properties:
        data:
          type: array
          description: Array of search term rows
        meta:
          type: object
          description: Metadata including pagination
    GetV1CatalogListingChangesResponse:
      type: object
      properties:
        data:
          type: array
          description: Array of listing change rows
        meta:
          type: object
          description: Metadata including freshness
    GetV1CatalogListingStateResponse:
      type: object
      properties:
        data:
          type: array
          description: Array of listing state rows
        meta:
          type: object
          description: Metadata including filters and warnings
    PostV1ResponsesRequest:
      type: object
      properties:
        model:
          type: string
        tools:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
              server_label:
                type: string
              server_url:
                type: string
              server_description:
                type: string
              headers:
                type: object
                properties:
                  Authorization:
                    type: string
              require_approval:
                type: string
        input:
          type: string
    PostV1ResponsesResponse:
      type: object
      properties:
        model:
          type: string
        tools:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
              server_label:
                type: string
              server_url:
                type: string
              server_description:
                type: string
              headers:
                type: object
                properties:
                  Authorization:
                    type: string
              require_approval:
                type: string
        input:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Account
- name: Ads
- name: Catalog
- name: Finance
- name: Responses
- name: Sd
- name: Skus