{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MCP tools","description":"Guides and API reference for the DataSift (REISift) Core API and SiftMap API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-tools","__idx":0},"children":["MCP tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The project adds custom tools to Redocly's built-in documentation MCP server. They are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["documentation-only"]},": each returns a DataSift API operation's documented method, path, parameters, and response shape. They do not call the DataSift backend or return customer records."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"read-only-reference-tools","__idx":1},"children":["Read-only reference tools"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"MCP tool"},"children":["MCP tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"DataSift operation"},"children":["DataSift operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method and path"},"children":["Method and path"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search-properties"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["autocompletePropertyElastic"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/property/autocomplete/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-property"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retrieveProperty"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/property/{uuid}/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-property-history"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logsLogElastic"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/property/{uuid}/logs/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-owner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retrieveOwner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/owner/{uuid}/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-owner-phones"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retrieveOwner"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/owner/{uuid}/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-phone-tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listPhoneTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/phone/tag/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-custom-fields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listCustomFields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/custom-fields/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-property-custom-fields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listCustomFieldValues"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/property/{property_uuid}/custom-field/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-tasks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listTasks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/task/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-task"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retrieveTask"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/task/{uuid}/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-task-presets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listTaskPresets"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/task-preset/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/tag/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-lists"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listLists"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/list/"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-activity-status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listActivities"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/activity/"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are custom tools with the given names; none collide with Redocly's built-in tool names. The local ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@redocly/framework@0.140.0"]}," preview listed and allowed direct calls to all 14 tools both at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," and at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp?mode=tools"]},". Redocly can select a code-mode interface on eligible plans, where custom tools are called through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute"]}," and described with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["describe-tools"]},"; verify the mode available on the connected project after synchronization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-contract-limitations","__idx":2},"children":["API contract limitations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The OpenAPI operation for property autocomplete declares no query parameters. The use-case playbook shows ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["search"]},", but it is not represented in that operation's OpenAPI schema. No sorting or pagination is documented for autocomplete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The property collection operation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["listProperties"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/property/"]},") documents ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," only. It has no documented search/filter/order parameters, so the existing API description does not support a fully filterable, sortable property search tool."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list-tasks"]}," documents ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," only; no task filters are declared in the API schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Owner phone details are embedded in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Owner"]}," response (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phones"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_phones"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary_phone"]},"); the API has no separate GET owner-phones operation. The documented ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone"]}," fields include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_connected"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-activity-status"]}," describes the paginated activity feed and its status/progress fields. There is no documented GET operation for a single activity by UUID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Results identify the API response schema but are not returned by these tools. Each output explicitly says ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentation-only"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveDataReturned: false"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication-and-executable-api-calls","__idx":3},"children":["Authentication and executable API calls"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DataSift requests require a customer-specific Open API key in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Api-Key ..."]},". Redocly MCP authentication identifies a Redocly documentation user; its token is not a DataSift key and does not authorize API calls. The Enterprise code-mode preview also exposes Redocly's separate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manageApiCredentials"]}," and OpenAPI-aware ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fetch"]}," tools, which accept a security-scheme name and restrict calls to documented read methods. That is a built-in API-call path, not an API-credential interface available to custom handlers: Redocly's documented ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["McpToolContext"]}," exposes no managed DataSift credential or credential-aware fetch method. This repository has no customer-scoped exchange or backend credential integration for custom handlers. Therefore no custom tool accepts, stores, forwards, or returns credentials, and no custom tool makes a live DataSift request. Redocly plan entitlement and code-mode execution must be verified for the deployed legacy project before relying on its separate built-in API-call path."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following requested write operations are intentionally ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not executable"]},":"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Proposed operation"},"children":["Proposed operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Documented DataSift route"},"children":["Documented DataSift route"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"State"},"children":["State"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apply-property-tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/internal/property/{uuid}/add-tags/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled until customer-scoped authentication, authorization, duplicate-request controls, and audit handling are implemented."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update-property-custom-fields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/internal/property/{property_uuid}/custom-field/update-values/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled for the same authentication and authorization blockers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create-task"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/internal/task/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled for the same authentication and authorization blockers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["update-task"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/internal/task/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled for the same authentication and authorization blockers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apply-phone-tags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/internal/phone/add-phone-tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled for the same authentication and authorization blockers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preview-bulk-operation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unsupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No generic DataSift bulk-operation preview endpoint is documented."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute-bulk-operation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unsupported"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No generic DataSift bulk-operation execution endpoint is documented. The API documents specific operations, not a generic write interface."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before enabling writes, provide a verified mechanism that maps the authenticated MCP caller to that caller's own DataSift credential (or a backend token exchange), enforce the caller's DataSift permissions, and define idempotency, audit, rate-limit, and billing safeguards for paid/asynchronous operations. Never use a shared administrative key. No production writes are part of local validation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"test-after-redocly-synchronization","__idx":4},"children":["Test after Redocly synchronization"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Push a change to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["main"]}," and wait for the connected Redocly project to synchronize and publish successfully."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Connect an MCP client to the project's root ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," endpoint using the project URL assigned by Redocly; do not substitute the documentation site URL for the DataSift API server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["describe-tools"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute"]}," to discover and call custom tools. With a client supporting tools mode, append ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?mode=tools"]}," to the MCP endpoint and verify the individual tool names are listed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try the example prompts:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show me the documented property autocomplete request for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 Main St"]}," and explain which search parameters the OpenAPI schema actually declares.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"What response schema does ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get-owner-phones"]}," describe, and which phone status/type fields are documented?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show the documented custom-field filters for searching active property fields in group 12.\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"What pagination parameters can I use for tasks, and does the API document filters by property?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show how to read an activity's status and tell me whether there is a single-activity status endpoint.\""]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm tool results report ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["executionMode: documentation-only"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["liveDataReturned: false"]},". The local Framework 0.140.0 tools-mode preview omits ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outputSchema"]}," from the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tools/list"]}," wire representation; each tool declares an output schema in source and the Redocly build accepts it. The local Enterprise preview exposed the code-mode signatures through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["describe-tools"]},", but ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["execute"]}," calls failed with a Framework dispatch error (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MCP tool \"execute\" is not registered..."]},"), including a no-op script. Direct tools-mode calls succeeded. Recheck code-mode execution against the synchronized cloud runtime before relying on it. Live account reads require a separate, approved customer-scoped DataSift authentication integration."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Redocly's current tool contract and authorization behavior, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://redocly.com/docs/platform/customization/mcp-server/custom-tools"},"children":["Custom MCP tools guide"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://redocly.com/docs/platform/customization/mcp-server/access"},"children":["MCP access guide"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"local-validation","__idx":5},"children":["Local validation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the repository's existing Redocly CLI setup:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npx --yes @redocly/cli@2 lint --format=github-actions\nnpx --yes @redocly/cli@2 preview --plan=pro\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The preview build should discover tools under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@mcp/"]},". The project remains on its existing Git-connected Redocly deployment workflow; no separate server or deployment URL is configured here."]}]},"headings":[{"value":"MCP tools","id":"mcp-tools","depth":1},{"value":"Read-only reference tools","id":"read-only-reference-tools","depth":2},{"value":"API contract limitations","id":"api-contract-limitations","depth":2},{"value":"Authentication and executable API calls","id":"authentication-and-executable-api-calls","depth":2},{"value":"Test after Redocly synchronization","id":"test-after-redocly-synchronization","depth":2},{"value":"Local validation","id":"local-validation","depth":2}],"frontmatter":{"seo":{"title":"MCP tools"}},"lastModified":"2026-11-05T16:09:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/mcp-tools","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}