{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "returnlogic.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "104.21.62.184",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "172.67.138.37",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 756,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.62.184",
          "172.67.138.37",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-22T19:19:01.582Z",
        "last_seen": "2026-11-22T19:19:01.582Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "returnlogic-mcp",
      "version": "1.7.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 755,
      "sample": [
        {
          "id": "22186",
          "url": "https://mcp.easyscribe.guide/mcp",
          "server_name": "guide.easyscribe/easy-scribe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T17:59:02.319Z"
        },
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        }
      ]
    },
    "same_site": {
      "total": 1096,
      "sample": [
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        },
        {
          "id": "42106",
          "url": "https://adminpulse.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adminpulse",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:29:00.620Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.usefulapi",
      "total": 1096,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/m190/usefulapi-mcp",
      "total": 1096,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "42839",
    "server_name": "io.usefulapi/returnlogic",
    "url": "https://returnlogic.usefulapi.io/mcp",
    "host": "returnlogic.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T19:19:01.582Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "0cfaa898fa54fcb3e5d34f70b45c80800252fb288abec502a0cf5d52fd6bd645",
    "first_listed_at": "2026-11-22T19:19:01.582Z",
    "created_at": "2026-11-21T12:40:13.682Z",
    "resolved_addresses": [
      "104.21.62.184",
      "172.67.138.37",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/returnlogic",
    "title": "ReturnLogic MCP by usefulapi",
    "description": "Read returns, orders and products; flag returns and mark items received in ReturnLogic.",
    "version": "1.7.0",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/returnlogic/",
    "published_at": "2026-11-21T01:01:59.065Z",
    "updated_at": "2026-11-21T01:01:59.065Z",
    "first_seen": "2026-11-21T12:40:13.029Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T19:19:14.480Z"
  },
  "operator": {
    "key": "usefulapi.io",
    "name": "usefulapi.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 199,
    "first_check_in_window": "2026-11-22T19:19:01.582Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "0cfaa898fa54fcb3e5d34f70b45c80800252fb288abec502a0cf5d52fd6bd645",
    "tools": 18,
    "resources": 0,
    "prompts": 7,
    "first_seen": "2026-11-22T19:19:01.791Z",
    "tool_names": [
      "returnlogic_list_rmas",
      "returnlogic_count_rmas",
      "returnlogic_get_rma",
      "returnlogic_get_rma_item_type_history",
      "returnlogic_get_rma_metafields",
      "returnlogic_get_rma_item_metafields",
      "returnlogic_list_orders",
      "returnlogic_count_orders",
      "returnlogic_get_order",
      "returnlogic_list_customers",
      "returnlogic_get_customer",
      "returnlogic_list_products",
      "returnlogic_count_products",
      "returnlogic_get_product",
      "returnlogic_list_product_categories",
      "returnlogic_flag_rma",
      "returnlogic_mark_rma_items_received",
      "returnlogic_add_rma_metafields"
    ],
    "declared": {
      "tools": [
        {
          "name": "returnlogic_list_rmas",
          "title": "List returns (RMAs)",
          "description": "List return merchandise authorizations (RMAs, i.e. customer returns) with workflow status, return type (refund, exchange, warranty, giftcard), items, customer email and order. Filter by status, type, reason, email, order, date range, flags or 'requires action'. GET /v1/rmas.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "skip": {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 0,
                "description": "Number of items to skip (default 0). Pass the previous reply's next_skip."
              },
              "email": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 254,
                  "minLength": 1,
                  "description": "An email address."
                },
                "maxItems": 20,
                "description": "RMAs whose RMA email or order email matches one of these (case-insensitive, exact)."
              },
              "limit": {
                "type": "integer",
                "maximum": 250,
                "description": "Items to return, 1-250 (default 25).",
                "exclusiveMinimum": 0
              },
              "order_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The human-readable order name, e.g. #1001."
              },
              "return_type": {
                "type": "array",
                "items": {
                  "enum": [
                    "exchange",
                    "warranty",
                    "refund",
                    "giftcard"
                  ],
                  "type": "string"
                },
                "maxItems": 4,
                "description": "Only RMAs with one of these return types."
              },
              "only_flagged": {
                "type": "boolean",
                "description": "Only flagged RMAs."
              },
              "created_after": {
                "type": "string",
                "description": "Only RMAs created on or after this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "show_archived": {
                "type": "boolean",
                "description": "true = only archived RMAs, false = only non-archived."
              },
              "created_before": {
                "type": "string",
                "description": "Only RMAs created on or before this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "requires_action": {
                "type": "boolean",
                "description": "Only RMAs that are not scheduled for automatic processing and need a person."
              },
              "workflow_status": {
                "type": "array",
                "items": {
                  "enum": [
                    "Abandoned",
                    "Requested",
                    "Authorized",
                    "Canceled",
                    "InTransit",
                    "Delivered",
                    "Active",
                    "Received",
                    "Processed",
                    "Complete",
                    "Rejected"
                  ],
                  "type": "string"
                },
                "maxItems": 11,
                "description": "Only RMAs in one of these workflow statuses."
              },
              "third_party_only": {
                "type": "boolean",
                "description": "Only RMAs whose order is not from Shopify."
              },
              "return_reason_code": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1,
                  "description": "A return reason code."
                },
                "maxItems": 20,
                "description": "Only RMAs with one of these return reason codes."
              },
              "only_unpaid_invoices": {
                "type": "boolean",
                "description": "Only exchange or warranty RMAs with unpaid invoices."
              },
              "external_order_number": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The external (store) order number."
              },
              "only_warranty_out_of_stock": {
                "type": "boolean",
                "description": "Only RMAs flagged Contact Customer Support (warranty item out of stock)."
              }
            }
          },
          "annotations": {
            "title": "List returns (RMAs)",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_count_rmas",
          "title": "Count returns (RMAs)",
          "description": "Count RMAs matching the same filters as returnlogic_list_rmas (for example how many returns are Requested or require action). GET /v1/rmas/count.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "email": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 254,
                  "minLength": 1,
                  "description": "An email address."
                },
                "maxItems": 20,
                "description": "RMAs whose RMA email or order email matches one of these (case-insensitive, exact)."
              },
              "order_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The human-readable order name, e.g. #1001."
              },
              "return_type": {
                "type": "array",
                "items": {
                  "enum": [
                    "exchange",
                    "warranty",
                    "refund",
                    "giftcard"
                  ],
                  "type": "string"
                },
                "maxItems": 4,
                "description": "Only RMAs with one of these return types."
              },
              "only_flagged": {
                "type": "boolean",
                "description": "Only flagged RMAs."
              },
              "created_after": {
                "type": "string",
                "description": "Only RMAs created on or after this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "show_archived": {
                "type": "boolean",
                "description": "true = only archived RMAs, false = only non-archived."
              },
              "created_before": {
                "type": "string",
                "description": "Only RMAs created on or before this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "requires_action": {
                "type": "boolean",
                "description": "Only RMAs that are not scheduled for automatic processing and need a person."
              },
              "workflow_status": {
                "type": "array",
                "items": {
                  "enum": [
                    "Abandoned",
                    "Requested",
                    "Authorized",
                    "Canceled",
                    "InTransit",
                    "Delivered",
                    "Active",
                    "Received",
                    "Processed",
                    "Complete",
                    "Rejected"
                  ],
                  "type": "string"
                },
                "maxItems": 11,
                "description": "Only RMAs in one of these workflow statuses."
              },
              "third_party_only": {
                "type": "boolean",
                "description": "Only RMAs whose order is not from Shopify."
              },
              "return_reason_code": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1,
                  "description": "A return reason code."
                },
                "maxItems": 20,
                "description": "Only RMAs with one of these return reason codes."
              },
              "only_unpaid_invoices": {
                "type": "boolean",
                "description": "Only exchange or warranty RMAs with unpaid invoices."
              },
              "external_order_number": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The external (store) order number."
              },
              "only_warranty_out_of_stock": {
                "type": "boolean",
                "description": "Only RMAs flagged Contact Customer Support (warranty item out of stock)."
              }
            }
          },
          "annotations": {
            "title": "Count returns (RMAs)",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_rma",
          "title": "Get return (RMA)",
          "description": "One RMA by id: status, comments, order link, shopper and warehouse addresses, items with quantities, reasons, approval/receipt state, labels and timeline. GET /v1/rmas/{rlRmaId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id"
            ],
            "properties": {
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id (rlRmaId).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get return (RMA)",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_rma_item_type_history",
          "title": "Get return type history of an RMA item",
          "description": "The history of return-type changes (e.g. refund changed to exchange) of one RMA item. GET /v1/rmas/{rlRmaItemId}/returntypehistory.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_item_id"
            ],
            "properties": {
              "rma_item_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA item id (rlRmaItemId, from an RMA's items).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get return type history",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_rma_metafields",
          "title": "Get RMA metafields",
          "description": "Custom metafields (key, value, reportable) stored on an RMA. GET /v1/rmas/{rlRmaId}/metafields.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id"
            ],
            "properties": {
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get RMA metafields",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_rma_item_metafields",
          "title": "Get RMA item metafields",
          "description": "Custom metafields stored on one item of an RMA. GET /v1/rmas/{rlRmaId}/items/{rlRmaItemId}/metafields.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id",
              "rma_item_id"
            ],
            "properties": {
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id.",
                "exclusiveMinimum": 0
              },
              "rma_item_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA item id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get RMA item metafields",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_list_orders",
          "title": "List orders",
          "description": "List orders known to ReturnLogic (synced from the store) with items, customer, amounts and statuses. Filter by order number/name, email, date range or financial status. GET /v1/orders.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "skip": {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 0,
                "description": "Number of items to skip (default 0). Pass the previous reply's next_skip."
              },
              "email": {
                "type": "string",
                "maxLength": 254,
                "minLength": 1,
                "description": "Find orders by customer email (case-insensitive, exact)."
              },
              "limit": {
                "type": "integer",
                "maximum": 250,
                "description": "Items to return, 1-250 (default 25).",
                "exclusiveMinimum": 0
              },
              "order_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Find orders by order name, e.g. #1001."
              },
              "order_number": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Find orders by order number."
              },
              "created_after": {
                "type": "string",
                "description": "Only orders created on or after this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "created_before": {
                "type": "string",
                "description": "Only orders created on or before this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "financial_status": {
                "enum": [
                  "authorized",
                  "paid",
                  "partially_paid",
                  "pending",
                  "refunded",
                  "voided",
                  "ThirdParty"
                ],
                "type": "string",
                "description": "Only orders with this financial status."
              }
            }
          },
          "annotations": {
            "title": "List orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_count_orders",
          "title": "Count orders",
          "description": "Count orders matching the same filters as returnlogic_list_orders. GET /v1/orders/count.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "email": {
                "type": "string",
                "maxLength": 254,
                "minLength": 1,
                "description": "Find orders by customer email (case-insensitive, exact)."
              },
              "order_name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Find orders by order name, e.g. #1001."
              },
              "order_number": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Find orders by order number."
              },
              "created_after": {
                "type": "string",
                "description": "Only orders created on or after this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "created_before": {
                "type": "string",
                "description": "Only orders created on or before this moment. A date (yyyy-mm-dd) or an ISO 8601 date-time."
              },
              "financial_status": {
                "enum": [
                  "authorized",
                  "paid",
                  "partially_paid",
                  "pending",
                  "refunded",
                  "voided",
                  "ThirdParty"
                ],
                "type": "string",
                "description": "Only orders with this financial status."
              }
            }
          },
          "annotations": {
            "title": "Count orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_order",
          "title": "Get order",
          "description": "One order by ReturnLogic order id (rlOrderId) with its line items, addresses and statuses. GET /v1/orders/{rlOrderId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "order_id"
            ],
            "properties": {
              "order_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic order id (rlOrderId; the rlOrderId field of an RMA).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get order",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_list_customers",
          "title": "List customers",
          "description": "List customers, or find one by email or external customer id. GET /v1/customers/list.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "skip": {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 0,
                "description": "Number of items to skip (default 0). Pass the previous reply's next_skip."
              },
              "email": {
                "type": "string",
                "maxLength": 254,
                "minLength": 1,
                "description": "Customer email address."
              },
              "limit": {
                "type": "integer",
                "maximum": 250,
                "description": "Items to return, 1-250 (default 25).",
                "exclusiveMinimum": 0
              },
              "external_customer_id": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "The customer's id in the store (e.g. the Shopify customer id)."
              }
            }
          },
          "annotations": {
            "title": "List customers",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_customer",
          "title": "Get customer",
          "description": "One customer by ReturnLogic customer id (rlCustomerId). GET /v1/customers/{rlCustomerId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "customer_id"
            ],
            "properties": {
              "customer_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic customer id (rlCustomerId).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get customer",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_list_products",
          "title": "List products",
          "description": "List products with their variants (SKUs, barcodes). Filter by SKU, category id, status or external (store) product ids. GET /v1/products.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "sku": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Only products with a variant matching this SKU."
              },
              "skip": {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 0,
                "description": "Number of items to skip (default 0). Pass the previous reply's next_skip."
              },
              "limit": {
                "type": "integer",
                "maximum": 250,
                "description": "Items to return, 1-250 (default 25).",
                "exclusiveMinimum": 0
              },
              "status": {
                "enum": [
                  "active",
                  "inActive",
                  "any"
                ],
                "type": "string",
                "description": "active, inActive or any (default per API)."
              },
              "category_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "Only products in this ReturnLogic category id.",
                "exclusiveMinimum": 0
              },
              "external_product_ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1,
                  "description": "An external (store) product id."
                },
                "maxItems": 50,
                "description": "Only products matching these store product ids."
              }
            }
          },
          "annotations": {
            "title": "List products",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_count_products",
          "title": "Count products",
          "description": "Count products matching a SKU, category or status filter. GET /v1/products/count.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "sku": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Only products with a variant matching this SKU."
              },
              "status": {
                "enum": [
                  "active",
                  "inActive",
                  "any"
                ],
                "type": "string",
                "description": "active, inActive or any (default per API)."
              },
              "category_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "Only products in this ReturnLogic category id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Count products",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_get_product",
          "title": "Get product",
          "description": "One product by ReturnLogic product id (rlProductId) with its variants. GET /v1/products/{rlProductId}.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "product_id"
            ],
            "properties": {
              "product_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic product id (rlProductId).",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Get product",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_list_product_categories",
          "title": "List product categories",
          "description": "List product categories (used for return rules). Search by name or external category ids. GET /v1/productCategories.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1,
                "description": "Category name to search for."
              },
              "skip": {
                "type": "integer",
                "maximum": 2147483647,
                "minimum": 0,
                "description": "Number of items to skip (default 0). Pass the previous reply's next_skip."
              },
              "limit": {
                "type": "integer",
                "maximum": 250,
                "description": "Items to return, 1-250 (default 25).",
                "exclusiveMinimum": 0
              },
              "external_category_ids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1,
                  "description": "An external (store) category id."
                },
                "maxItems": 50,
                "description": "Only categories matching these store category ids."
              }
            }
          },
          "annotations": {
            "title": "List product categories",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "returnlogic_flag_rma",
          "title": "Flag an RMA",
          "description": "WRITE: flag an RMA so the team can filter for it, with an optional comment. A flag cannot be removed afterwards. It sends nothing to the customer. POST /v1/rmas/{rlRmaId}/flag.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id"
            ],
            "properties": {
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id.",
                "exclusiveMinimum": 0
              },
              "comment": {
                "type": "string",
                "maxLength": 1000,
                "minLength": 1,
                "description": "Why the RMA is flagged (visible to the team)."
              }
            }
          },
          "annotations": {
            "title": "Flag an RMA",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "returnlogic_mark_rma_items_received",
          "title": "Mark RMA items received",
          "description": "WRITE: record the warehouse receipt of one or more RMA items (received true/false, optional disposition code that must already exist in ReturnLogic). When every item is received the RMA becomes Received, and if the store uses Automated Processing for Received, the RMA may then be processed automatically (refund, exchange or gift card issued, and the customer notified by ReturnLogic). Use only on the operator's instruction. PUT /v1/rmas/{rlRmaId}/fulfillment.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id",
              "items"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "rma_item_id",
                    "received"
                  ],
                  "properties": {
                    "received": {
                      "type": "boolean",
                      "description": "true = the item arrived at the warehouse, false = not (yet) received."
                    },
                    "rma_item_id": {
                      "type": "integer",
                      "maximum": 2147483647,
                      "description": "ReturnLogic RMA item id (rlRmaItemId).",
                      "exclusiveMinimum": 0
                    },
                    "disposition_code": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1,
                      "description": "An existing disposition code to record for the item."
                    },
                    "disposition_comment": {
                      "type": "string",
                      "maxLength": 1000,
                      "minLength": 1,
                      "description": "Comment stored with the disposition."
                    }
                  }
                },
                "maxItems": 100,
                "minItems": 1,
                "description": "The items to update."
              },
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id.",
                "exclusiveMinimum": 0
              }
            }
          },
          "annotations": {
            "title": "Mark RMA items received",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "returnlogic_add_rma_metafields",
          "title": "Add RMA metafields",
          "description": "WRITE: add custom metafields (key/value notes or reference numbers) to an RMA. A key can be used once per RMA. 'reportable' true makes the field visible on RMAs and reports; false keeps it API-only. Nothing is sent to the customer. POST /v1/rmas/{rlRmaId}/metafields.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "rma_id",
              "metafields"
            ],
            "properties": {
              "rma_id": {
                "type": "integer",
                "maximum": 2147483647,
                "description": "ReturnLogic RMA id.",
                "exclusiveMinimum": 0
              },
              "metafields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "key",
                    "value",
                    "reportable"
                  ],
                  "properties": {
                    "key": {
                      "type": "string",
                      "maxLength": 100,
                      "minLength": 1,
                      "description": "Metafield key (name), unique per RMA."
                    },
                    "value": {
                      "type": "string",
                      "maxLength": 2000,
                      "description": "Metafield value."
                    },
                    "reportable": {
                      "type": "boolean",
                      "description": "true = visible on RMAs and reports; false = only available through the API."
                    }
                  }
                },
                "maxItems": 20,
                "minItems": 1,
                "description": "The metafields to create."
              }
            }
          },
          "annotations": {
            "title": "Add RMA metafields",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with ReturnLogic here, with example requests to try."
        },
        {
          "name": "find_returns_that_need_action",
          "description": "Count the returns that require action, then list them by status, return type or date range."
        },
        {
          "name": "review_one_return_and_its_history",
          "description": "Open one return to see its comments, items, reasons and timeline. Read the return-type changes of one item."
        },
        {
          "name": "look_up_an_order_and_its_customer",
          "description": "Find an order by number or customer email, then read its items, addresses and statuses, and the customer record."
        },
        {
          "name": "check_products_and_return_categories",
          "description": "Look up products by SKU and read their variants. List the product categories that return rules use."
        },
        {
          "name": "flag_a_return_for_the_team",
          "description": "Flag a return with an optional comment, so the team can filter for it. A flag cannot be removed, and nothing is sent to the customer."
        },
        {
          "name": "mark_return_items_received",
          "description": "Record the warehouse receipt of return items. When every item is received, the store may process the return automatically."
        }
      ]
    },
    "instructions": "Tools for ReturnLogic, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: \"Which returns are waiting for my action right now?\"; \"Show me all refund returns requested this week and their reasons.\"; \"Look up the return for order #1042 and tell me what has been received.\". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ReturnLogic data. Free plan: 50 tool calls per month. Run returnlogic_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run returnlogic_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run returnlogic_upgrade without a plan: it returns both plans, each with a payment link for the user to open. returnlogic_cancel_subscription cancels Pro at the end of the paid period."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}