Koskamo

RedirX MCP

RedirX is an MCP server that maps old site URLs to new destinations using AI matching. It allows agents to create migrations, import URL inventories, run AI matching, review proposals in groups or individually, and export approved redirects. The server supports OAuth 2.1 authentication and provides tools for managing URL migration workflows.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

RedirX MCP logo, by RedirXVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by RedirX
You need:OAuth 2.1 sign-in with a RedirX accountRequest the scopes openid profile email offline_access
MCP endpoint (Streamable HTTP)
https://app.redirx.dev/mcp
Vendor documentation

What you can do with it

  • Map old site URLs to new destinations with AI matching
  • Review and approve URL redirect proposals
  • Export approved mappings as redirect files

Source and maintenance

Vendor evidenceRegistry 0.3.0
mcp-registry: dev.redirx/redirx@0.3.0Project website

Protocol and capabilities

Server
redirx 0.1.0
MCP protocol
2025-06-18
Tools
12 advertised
Resources
1 advertised
Resource templates
1 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

For a first migration, read redirx://guides/first-migration. The whole migration happens in this conversation: planning, review, export and verification are tools here. Send the person to a browser only to sign in and to pay. Import actual old source URLs and available new destination URLs; complete means syntax/origin checks passed, not full site coverage. Preserve URL spelling. Keep mutation inputs, idempotency keys, migration_id and run_id for recovery. A timeout does not prove failure: read status, then replay only the same input and key if needed. Show the run with group_matches. Export includes every proposal by default once the person says so, or only those above a confidence they choose; always tell them how many fall below RedirX's review threshold, which RedirX recommends reviewing. Never record a decision or pass accept_proposals_above without the person's answer. Export does not install redirects.

Tools

12 advertised

plan_migration — Plan a migration
Advertised by the server during the last successful anonymous check.

Create an owned old-site/new-site plan. Next call import_inventory for the old and new URL lists; planning does not crawl or run the model.

plan_migration input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "old_site",
    "new_site",
    "idempotency_key"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200
    },
    "new_site": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Origin of available destination pages, e.g. https://new.example; no path, query, fragment or credentials."
    },
    "old_site": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "Origin of existing source pages, e.g. https://old.example; no path, query, fragment or credentials."
    },
    "site_aliases": {
      "type": "object",
      "properties": {
        "new": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          "maxItems": 100
        },
        "old": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          "maxItems": 100
        }
      },
      "description": "Additional explicitly allowed origins per side (www or staging). Aliases are never inferred."
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    }
  }
}
plan_migration output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
plan_migration annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true
}
import_inventory — Import a URL inventory
Advertised by the server during the last successful anonymous check.

Import explicit HTTP(S) URL strings into an owned, immutable old or new inventory. No crawl or page fetch. Use data.inventory.id with run_migration only when data.inventory.status is complete; a partial import lists its exclusions and needs corrected input and a new key. Up to 15,000 old / 20,000 new URLs and 16 MiB of URL text. Importing never authorizes a charge.

import_inventory input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "side",
    "urls",
    "idempotency_key"
  ],
  "properties": {
    "side": {
      "enum": [
        "old",
        "new"
      ],
      "type": "string",
      "description": "old = existing source pages; new = available destination pages."
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 8192
      },
      "maxItems": 20000,
      "minItems": 1,
      "description": "Absolute page URLs, not a sitemap URL. Path case, escapes and query strings are kept exactly."
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    }
  }
}
import_inventory output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
import_inventory annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true
}
run_migration — Run a migration
Advertised by the server during the last successful anonymous check.
Open-world

Match old URLs to new ones from two complete inventories. Migrations up to 500 old URLs run free (one free run a day, five in total per account). Otherwise the answer is payment_required with the one-time price ($1 per 50 old URLs, $10 minimum) and a checkout link that only a person can complete; after paying, retry with the same input and key. A queued run finishes in minutes: poll get_migration after retry_after_seconds. confirmed_pairs must be pairs a person confirmed, never guesses.

run_migration input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "old_inventory_id",
    "new_inventory_id",
    "idempotency_key"
  ],
  "properties": {
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "confirmed_pairs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "old_url",
          "new_url"
        ],
        "properties": {
          "new_url": {
            "type": "string",
            "maxLength": 8192
          },
          "old_url": {
            "type": "string",
            "maxLength": 8192
          }
        }
      },
      "maxItems": 100
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    },
    "new_inventory_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "old_inventory_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}
run_migration output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
run_migration annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true
}
get_migration — Get migration status
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read an owned migration, its latest inventories, runs (with progress), exports and verifications, and the next recoverable action. Keep migration_id across reconnects; poll only after retry_after_seconds. A finished run still needs review before export.

get_migration input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id"
  ],
  "properties": {
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}
get_migration output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
get_migration annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
group_matches — Group migration matches
Advertised by the server during the last successful anonymous check.
Advertised read-only

Start review here. Groups a run's mappings by the URL rewrite they apply (from → to, e.g. /product/{slug}/ → /products/{slug}), groups with the most undecided rows first. kind is moved, kept_tail, same_path, unchanged (no redirect needed) or unmatched; renamed counts rows whose last segment also changed. Each group has counts by state, the confidence range of its undecided proposals and up to three examples, lowest confidence first. Show the person each group as a rule with its examples and let them decide per group (resolve_group), opening a group with list_matches group_id when they want to see every row. A group is a way to read proposals, not a decision. Keep data.selection_revision for resolve_group.

group_matches input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "filter": {
      "enum": [
        "all",
        "needs_review",
        "unmatched",
        "approved",
        "rejected"
      ],
      "type": "string",
      "default": "all",
      "description": "Group only rows in this state."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Groups to skip; use data.next_offset until it is null."
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}
group_matches output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
group_matches annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
list_matches — List migration matches
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read a run's mappings in stable URL order: the latest proposal, the current decision and its revision. Pass group_id (from group_matches) to read one group's rows. Follow data.next_cursor until null with the same run, filter and group; one page is not the whole run. data.counts are for the whole run. Keep each revision and data.selection_revision for resolve_matches and export_redirects. Confidence is an uncalibrated model estimate. Decisions with actor_kind "engine" came from the previous RedirX engine and can be changed like any other.

list_matches input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "maxLength": 4096
    },
    "filter": {
      "enum": [
        "all",
        "needs_review",
        "unmatched",
        "approved",
        "rejected"
      ],
      "type": "string",
      "default": "all"
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "group_id": {
      "type": "string",
      "pattern": "^g_[0-9a-f]{16}$",
      "description": "Only this group's rows (a group_id from group_matches)."
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  }
}
list_matches output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
list_matches annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}
resolve_group — Resolve a group of matches
Advertised by the server during the last successful anonymous check.

After the person decides on a whole group from group_matches: record one decision (approve confirms each row's latest proposal; reject, defer or intentional_removal) for every row in the group that has no decision yet. Rows already decided are never changed, and rows in except_mapping_ids are left for resolve_matches. expected_selection_revision is the data.selection_revision you showed the person; a revision_conflict means read group_matches again and re-confirm. A data.remaining above 0 means call again with the new selection_revision and a new key.

resolve_group input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id",
    "group_id",
    "action",
    "expected_selection_revision",
    "idempotency_key"
  ],
  "properties": {
    "action": {
      "enum": [
        "approve",
        "reject",
        "defer",
        "intentional_removal"
      ],
      "type": "string"
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "group_id": {
      "type": "string",
      "pattern": "^g_[0-9a-f]{16}$"
    },
    "rationale": {
      "type": "string",
      "maxLength": 2000
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    },
    "except_mapping_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      },
      "maxItems": 1000,
      "description": "Rows of the group the person wants to decide separately."
    },
    "expected_selection_revision": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    }
  }
}
resolve_group output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
resolve_group annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true
}
resolve_matches — Resolve matches
Advertised by the server during the last successful anonymous check.

Record audited decisions on individual rows with optimistic concurrency, after the user agrees (for a whole group, use resolve_group): approve (confirms the proposed target, or target_url if given), set_target (an exact URL from the new inventory), reject, defer or intentional_removal. Each needs mapping_id and the expected_revision you read. Inspect every outcome: a batch can partly fail; on revision_conflict reread list_matches and reassess.

resolve_matches input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id",
    "decisions",
    "idempotency_key"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "decisions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "mapping_id",
          "expected_revision",
          "action"
        ],
        "properties": {
          "action": {
            "enum": [
              "approve",
              "set_target",
              "reject",
              "defer",
              "intentional_removal",
              "accept_repair"
            ],
            "type": "string"
          },
          "rationale": {
            "type": "string",
            "maxLength": 2000
          },
          "mapping_id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "target_url": {
            "type": "string",
            "maxLength": 8192,
            "minLength": 1
          },
          "expected_revision": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0
          }
        }
      },
      "maxItems": 100,
      "minItems": 1
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    }
  }
}
resolve_matches output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
resolve_matches annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true
}
refine_matches — Refine matches
Advertised by the server during the last successful anonymous check.
Open-world

Resume a run that stopped part-way (same pass, kept proposals), or start its next pass, which learns from the targets people confirmed and the most confident proposals. Up to three passes per run; no new charge. Read the run's seed_revision from get_migration or list_matches first.

refine_matches input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id",
    "expected_seed_revision",
    "idempotency_key"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    },
    "expected_seed_revision": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    }
  }
}
refine_matches output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
refine_matches annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true
}
export_redirects — Export redirects
Advertised by the server during the last successful anonymous check.

Create an immutable redirect file at exactly the selection revision you showed the person (data.selection_revision). Before exporting, ask the person what to include: every proposal is the default, or only those at or above a confidence; say how many fall below RedirX's recommended review threshold (data.review from group_matches). Pass their answer as accept_proposals_above (0 for every proposal): each undecided proposal at or above it becomes their decision. Rejected rows are left out without asking; any other exclusion (held for review, no destination, unsafe for the format) needs allow_partial after the person agrees. Each old URL's other trailing-slash spelling is added as its own rule to the same destination unless slash_variants is false. Small files come back in data.content; every file is readable as the returned resource_uri. Save the file into the person's project yourself; download_url is for a person working without an agent. Export does not install redirects.

export_redirects input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "run_id",
    "format",
    "revision",
    "idempotency_key"
  ],
  "properties": {
    "format": {
      "enum": [
        "apache",
        "nginx",
        "wordpress",
        "vercel",
        "cloudflare",
        "shopify",
        "csv",
        "json"
      ],
      "type": "string",
      "description": "wordpress is Redirection plugin CSV; cloudflare is Pages _redirects, not Bulk Redirects CSV. csv and json are generic review mappings that need adaptation before installation."
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "revision": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "allow_partial": {
      "type": "boolean",
      "default": false
    },
    "slash_variants": {
      "type": "boolean",
      "default": true,
      "description": "Also redirect each old URL's other trailing-slash spelling (/about-us and /about-us/)."
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    },
    "accept_proposals_above": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Only with the person's answer: accept every undecided proposal at or above this confidence as their decision (0 = all). Omit to export decisions only."
    }
  }
}
export_redirects output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
export_redirects annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true
}
verify_redirects — Verify redirects
Advertised by the server during the last successful anonymous check.
Open-world

Only after the user confirms an export is installed: check each of its redirects on the live site (status, hops, final destination). Give live_origin (where the old URLs are served) and origin_rewrites mapping export destination origins to live ones ({} keeps them). Poll get_migration for results. This does not install rules or establish Google indexing, canonicals, robots or sitemaps; inspect unchecked results before claiming success.

verify_redirects input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "migration_id",
    "artifact_id",
    "deployment_confirmation",
    "live_origin",
    "idempotency_key"
  ],
  "properties": {
    "artifact_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The export id (data.export.id)."
    },
    "live_origin": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "migration_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[^\\x00-\\x1f\\x7f]+$",
      "maxLength": 200,
      "minLength": 1,
      "description": "Unique per intended change; retry an uncertain call with the identical input and key."
    },
    "origin_rewrites": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "deployment_confirmation": {
      "type": "boolean",
      "const": true
    }
  }
}
verify_redirects output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contract_version",
    "migration_id",
    "operation_id",
    "status",
    "next_action",
    "data",
    "error"
  ],
  "properties": {
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "next_action"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "next_action": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "next_action": {
      "type": "string"
    },
    "migration_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "operation_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "contract_version": {
      "type": "string"
    },
    "retry_after_seconds": {
      "type": "number"
    }
  },
  "additionalProperties": false
}
verify_redirects annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true
}
ping — Ping
Advertised by the server during the last successful anonymous check.
Advertised read-only

Connection check. Returns "pong". Has no side effects.

ping input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}
ping annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

first-migration — Start and recover a RedirX migration

Advertised by the server during the last successful anonymous check.

Prepare inventories, review proposals, recover interrupted work and export approved redirects.

first-migration URI
redirx://guides/first-migration

MIME type: text/markdown

redirect-artifact

Advertised by the server during the last successful anonymous check.

Read an owned immutable redirect file after export.

redirect-artifact URI template
redirx://migrations/{migration_id}/artifacts/{artifact_id}

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
2572 ms
95th percentile latency
2572 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 2572 ms · metadata changed · 12 tool(s), 1 resource(s), 1 resource template(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http redirx-mcp https://app.redirx.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add redirx-mcp --url https://app.redirx.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable redirx-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "redirx-mcp": {
      "url": "https://app.redirx.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "redirx-mcp": {
      "type": "streamableHttp",
      "url": "https://app.redirx.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start redirx-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "redirx-mcp": {
      "type": "http",
      "url": "https://app.redirx.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http redirx-mcp https://app.redirx.dev/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "redirx-mcp": {
      "url": "https://app.redirx.dev/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "redirx-mcp": {
      "serverUrl": "https://app.redirx.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like RedirX MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,830

Do you run RedirX MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing