KEYXE Developer Center · MCP

Understand the Tools Before You Use Them.

Every tool below is read-only, documented and runnable in your browser against synthetic data. Inspect its schema, try the example and copy the JSON. No write tools are offered, and none of these tools touch a real Amazon account.

Try the tools Download catalog JSON

Interactive demo · synthetic dataHosted MCP server: planned

Try the tools

Browser-local simulator. Running a tool performs no network request; results are synthetic and carry "is_live_amazon_data": false.

`analytics_query`

Runs a whitelisted aggregate query (no free-form SQL). Validates dataset, metrics, grouping, marketplace, date range and limit.

Demo only

Auth: Demo: none. Future production: scoped read permission per dataset.
Error codes: INVALID_ARGUMENTUNSUPPORTED_METRICUNSUPPORTED_GROUPINGINVALID_DATE_RANGE

Run the tool to see a JSON-RPC request and response. Nothing leaves your browser.

`accounts_list`

Demo only — live Amazon connections await approval

Lists the fictional demo connections. In the demo, no real Amazon account is ever connected.

Read-only: Yes
Auth requirement: Demo: none. Future production: KEYXE login + organization scope.
Error codes: INVALID_ARGUMENT

Try example in the demo

accounts_list · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "sp_api_seller",
        "ads_api_profile"
      ]
    }
  },
  "additionalProperties": false
}

arguments

{
  "kind": "all"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "accounts_list",
  "request_id": "demo-req-000001",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "These are fictional demo connections. No Amazon account is connected."
  ],
  "result": {
    "accounts": [
      {
        "account_id": "demo-seller-001",
        "kind": "sp_api_seller",
        "label": "Demo Seller Account (fictional)",
        "marketplaces": [
          "US",
          "CA",
          "UK",
          "DE"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-us",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · US (fictional)",
        "marketplaces": [
          "US"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-ca",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · CA (fictional)",
        "marketplaces": [
          "CA"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-uk",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · UK (fictional)",
        "marketplaces": [
          "UK"
        ],
        "connection_status": "demo_only",
        "live": false
      },
      {
        "account_id": "demo-ads-profile-de",
        "kind": "ads_api_profile",
        "label": "Demo Advertiser Profile · DE (fictional)",
        "marketplaces": [
          "DE"
        ],
        "connection_status": "demo_only",
        "live": false
      }
    ],
    "count": 5
  }
}

`datasets_search`

Demo only

Finds sample datasets by keyword and source category.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

datasets_search · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "type": "string",
      "maxLength": 100
    },
    "source": {
      "default": "all",
      "type": "string",
      "enum": [
        "all",
        "seller",
        "advertising",
        "inventory"
      ]
    }
  },
  "additionalProperties": false
}

arguments

{
  "query": "acos",
  "source": "all"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "datasets_search",
  "request_id": "demo-req-000002",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "datasets": [
      {
        "id": "sample_ads_campaign_daily",
        "title": "Sample advertising campaigns (daily)",
        "source": "advertising",
        "grain": "one row per campaign × day",
        "description": "Fictional impressions, clicks, spend and attributed sales for sample campaigns."
      }
    ],
    "count": 1
  }
}

`dataset_schema_get`

Demo only

Returns column names, types and the permission a production equivalent would need.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

dataset_schema_get · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_ads_campaign_daily"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "dataset_schema_get",
  "request_id": "demo-req-000003",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "dataset": "sample_ads_campaign_daily",
    "grain": "one row per campaign × day",
    "columns": [
      {
        "name": "date",
        "type": "date",
        "description": "Calendar day (sample)"
      },
      {
        "name": "campaign",
        "type": "string",
        "description": "Sample campaign name"
      },
      {
        "name": "format",
        "type": "string",
        "description": "Sponsored Products, Sponsored Brands or Sponsored Display (sample)"
      },
      {
        "name": "impressions",
        "type": "integer",
        "description": "Ad impressions"
      },
      {
        "name": "clicks",
        "type": "integer",
        "description": "Ad clicks"
      },
      {
        "name": "spend",
        "type": "decimal",
        "description": "Ad spend, local currency"
      },
      {
        "name": "attributed_sales",
        "type": "decimal",
        "description": "Sales attributed to ads, local currency"
      },
      {
        "name": "orders",
        "type": "integer",
        "description": "Attributed orders"
      },
      {
        "name": "ctr",
        "type": "ratio",
        "description": "clicks ÷ impressions"
      },
      {
        "name": "cpc",
        "type": "decimal",
        "description": "spend ÷ clicks"
      },
      {
        "name": "acos",
        "type": "ratio",
        "description": "spend ÷ attributed sales"
      },
      {
        "name": "roas",
        "type": "ratio",
        "description": "attributed sales ÷ spend"
      }
    ],
    "queryable_metrics": [
      "impressions",
      "clicks",
      "spend",
      "attributed_sales",
      "orders",
      "ctr",
      "cpc",
      "acos",
      "roas"
    ],
    "group_by_options": [
      "campaign",
      "format"
    ],
    "coverage": {
      "start": "2026-04-04",
      "end": "2026-09-30"
    },
    "required_permission": "demo:read (synthetic, no login)",
    "production_equivalent": "Would require Amazon Ads API access and advertiser authorization. Not available."
  }
}

`analytics_query`

Demo only

Runs a whitelisted aggregate query (no free-form SQL). Validates dataset, metrics, grouping, marketplace, date range and limit.

Read-only: Yes
Auth requirement: Demo: none. Future production: scoped read permission per dataset.
Error codes: INVALID_ARGUMENT, UNSUPPORTED_METRIC, UNSUPPORTED_GROUPING, INVALID_DATE_RANGE

Try example in the demo

analytics_query · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    },
    "metrics": {
      "minItems": 1,
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "group_by": {
      "type": "string"
    },
    "marketplace": {
      "default": "US",
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE"
      ],
      "description": "Sample marketplace code"
    },
    "date_range": {
      "default": {
        "preset": "30d"
      },
      "type": "object",
      "properties": {
        "preset": {
          "default": "30d",
          "type": "string",
          "enum": [
            "7d",
            "30d",
            "90d",
            "custom"
          ]
        },
        "start": {
          "description": "YYYY-MM-DD, on or after 2026-04-04",
          "type": "string"
        },
        "end": {
          "description": "YYYY-MM-DD, on or before 2026-09-30",
          "type": "string"
        }
      }
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_direction": {
      "default": "desc",
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ]
    }
  },
  "required": [
    "dataset",
    "metrics"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_ads_campaign_daily",
  "metrics": [
    "spend",
    "attributed_sales",
    "acos"
  ],
  "group_by": "campaign",
  "marketplace": "US",
  "date_range": {
    "preset": "30d"
  },
  "limit": 5
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "analytics_query",
  "request_id": "demo-req-000004",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": "Money in major units of the marketplace currency; ratios as decimals (0.25 = 25%).",
  "attribution": "Sample attributed sales/orders use a fictional attribution window. Not comparable to seller ordered sales.",
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "Showing 5 of 36 grouped rows (limit 5)."
  ],
  "result": {
    "dataset": "sample_ads_campaign_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30",
      "days": 30
    },
    "group_by": "campaign",
    "rows": [
      {
        "campaign": "Demo SP · Office · Automatic targeting · 13",
        "spend": 4133.95,
        "attributed_sales": 8957.03,
        "acos": 0.4615
      },
      {
        "campaign": "Demo SP · Home Storage · Exact keywords · 32",
        "spend": 2893.41,
        "attributed_sales": 7817.09,
        "acos": 0.3701
      },
      {
        "campaign": "Demo SP · Fitness · Phrase keywords · 10",
        "spend": 2553.25,
        "attributed_sales": 6285.09,
        "acos": 0.4062
      },
      {
        "campaign": "Demo SP · Home Storage · Product targets · 01",
        "spend": 2483.04,
        "attributed_sales": 5555.5,
        "acos": 0.447
      },
      {
        "campaign": "Demo SB · Lighting · Sample Brand A · phrase keywords · 14",
        "spend": 2376.42,
        "attributed_sales": 5784.13,
        "acos": 0.4109
      }
    ],
    "row_count": 5,
    "total_groups": 36
  }
}

`reports_create`

Demo only (simulated job)

Creates a simulated report job in this browser tab. No file leaves your browser and no network call is made.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT, INVALID_DATE_RANGE

Try example in the demo

reports_create · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "sample_seller_sales_daily",
        "sample_ads_campaign_daily",
        "sample_inventory_daily"
      ]
    },
    "marketplace": {
      "default": "US",
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE"
      ],
      "description": "Sample marketplace code"
    },
    "date_range": {
      "default": {
        "preset": "30d"
      },
      "type": "object",
      "properties": {
        "preset": {
          "default": "30d",
          "type": "string",
          "enum": [
            "7d",
            "30d",
            "90d",
            "custom"
          ]
        },
        "start": {
          "description": "YYYY-MM-DD, on or after 2026-04-04",
          "type": "string"
        },
        "end": {
          "description": "YYYY-MM-DD, on or before 2026-09-30",
          "type": "string"
        }
      }
    },
    "format": {
      "default": "csv",
      "type": "string",
      "enum": [
        "csv",
        "json"
      ]
    }
  },
  "required": [
    "dataset"
  ],
  "additionalProperties": false
}

arguments

{
  "dataset": "sample_seller_sales_daily",
  "marketplace": "US",
  "date_range": {
    "preset": "30d"
  },
  "format": "csv"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "reports_create",
  "request_id": "demo-req-000005",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made.",
    "Simulated job held in this browser tab only. Nothing is uploaded or sent."
  ],
  "result": {
    "job_id": "demo-job-0001",
    "status": "queued",
    "dataset": "sample_seller_sales_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30"
    },
    "format": "csv"
  }
}

`reports_status_get`

Demo only (simulated job)

Returns the simulated job state. Each check advances queued → processing → completed.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT, NOT_FOUND

Try example in the demo

reports_status_get · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^demo-job-\\d{4}$"
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

arguments

{
  "job_id": "demo-job-0001"
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "reports_status_get",
  "request_id": "demo-req-000007",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": "US",
  "currency": "USD",
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "job_id": "demo-job-0001",
    "status": "processing",
    "dataset": "sample_seller_sales_daily",
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30"
    },
    "format": "csv",
    "note": "Check again to advance the simulated job."
  }
}

`audit_events_list`

Demo only

Lists demo audit events, including the tool calls you made in this tab.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: INVALID_ARGUMENT

Try example in the demo

audit_events_list · inputSchema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false
}

arguments

{
  "limit": 10
}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "audit_events_list",
  "request_id": "demo-req-000008",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "events": [
      {
        "event_id": "demo-evt-008",
        "at": "2026-10-01T00:00:08Z",
        "actor": "you (this browser tab)",
        "action": "tool.audit_events_list",
        "detail": "{\"limit\":10}"
      },
      {
        "event_id": "demo-evt-007",
        "at": "2026-10-01T00:00:07Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_status_get",
        "detail": "{\"job_id\":\"demo-job-0001\"}"
      },
      {
        "event_id": "demo-evt-006",
        "at": "2026-10-01T00:00:06Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_create",
        "detail": "{\"dataset\":\"sample_seller_sales_daily\",\"marketplace\":\"US\",\"date_range\":{\"preset\":\"30d\"},\"format\":\"csv\"}"
      },
      {
        "event_id": "demo-evt-005",
        "at": "2026-10-01T00:00:05Z",
        "actor": "you (this browser tab)",
        "action": "tool.reports_create",
        "detail": "{\"dataset\":\"sample_seller_sales_daily\",\"marketplace\":\"US\",\"date_range\":{\"preset\":\"30d\"},\"format\":\"csv\"}"
      },
      {
        "event_id": "demo-evt-004",
        "at": "2026-10-01T00:00:04Z",
        "actor": "you (this browser tab)",
        "action": "tool.analytics_query",
        "detail": "{\"dataset\":\"sample_ads_campaign_daily\",\"metrics\":[\"spend\",\"attributed_sales\",\"acos\"],\"group_by\":\"campaign\",\"marketplace\""
      },
      {
        "event_id": "demo-evt-003",
        "at": "2026-10-01T00:00:03Z",
        "actor": "you (this browser tab)",
        "action": "tool.dataset_schema_get",
        "detail": "{\"dataset\":\"sample_ads_campaign_daily\"}"
      },
      {
        "event_id": "demo-evt-002",
        "at": "2026-10-01T00:00:02Z",
        "actor": "you (this browser tab)",
        "action": "tool.datasets_search",
        "detail": "{\"query\":\"acos\",\"source\":\"all\"}"
      },
      {
        "event_id": "demo-evt-001",
        "at": "2026-10-01T00:00:01Z",
        "actor": "you (this browser tab)",
        "action": "tool.accounts_list",
        "detail": "{\"kind\":\"all\"}"
      },
      {
        "event_id": "demo-evt-f01",
        "at": "2026-09-30T16:02:00Z",
        "actor": "demo-analyst (fictional)",
        "action": "report.created",
        "detail": "sample_seller_sales_daily · US · 30d"
      },
      {
        "event_id": "demo-evt-f02",
        "at": "2026-09-30T16:05:00Z",
        "actor": "demo-analyst (fictional)",
        "action": "proposal.drafted",
        "detail": "Bid −10% on a sample keyword target (not sent)"
      }
    ],
    "count": 10,
    "total_available": 11
  }
}

`usage_status_get`

Demo only

Shows how many simulated tool calls were made in this tab.

Read-only: Yes
Auth requirement: Demo: none.
Error codes: None

Try example in the demo

arguments

{}

structured output (generated by the simulator at build time)

{
  "mode": "synthetic_demo",
  "tool": "usage_status_get",
  "request_id": "demo-req-000009",
  "source": "keyxe_synthetic_fixtures",
  "org_bound": "demo-org (fictional)",
  "marketplace": null,
  "currency": null,
  "as_of": "2026-10-01T00:00:00Z",
  "units": null,
  "attribution": null,
  "is_live_amazon_data": false,
  "warnings": [
    "Synthetic sample data. No Amazon API call was made."
  ],
  "result": {
    "tool_calls_this_tab": 9,
    "report_jobs_this_tab": 2,
    "rate_limit": "Not applicable — the simulator runs entirely in your browser."
  }
}

Understand the Tools Before You Use Them.

Try the tools

analytics_query

Arguments

accounts_list

Input schema (JSON Schema)

Example arguments and output

datasets_search

Input schema (JSON Schema)

Example arguments and output

dataset_schema_get

Input schema (JSON Schema)

Example arguments and output

analytics_query

Input schema (JSON Schema)

Example arguments and output

reports_create

Input schema (JSON Schema)

Example arguments and output

reports_status_get

Input schema (JSON Schema)

Example arguments and output

audit_events_list

Input schema (JSON Schema)

Example arguments and output

usage_status_get

Input schema (JSON Schema)

Example arguments and output

`analytics_query`

`accounts_list`

`datasets_search`

`dataset_schema_get`

`analytics_query`

`reports_create`

`reports_status_get`

`audit_events_list`

`usage_status_get`