Reference

The Reference section provides comprehensive technical documentation for all APIs, configuration schemas, and runtime contracts exposed by the MarkLogic MCP Server and MarkLogic Retrieval API. This section is organized by component: the MarkLogic Retrieval API reference covers the three REST endpoints that perform search and retrieval operations, the MCP Server reference covers the server's runtime configuration and client integration contracts, and the Glossary provides definitions for domain-specific terminology.

The Reference section is designed for consultation during implementation and troubleshooting. When you need to understand the exact behavior of an endpoint, the structure of request or response fields, the syntax of configuration files, or the runtime effect of environment variables, consult the relevant reference page. When you need guidance on how to accomplish a task or understand how the system is designed, see the Concepts or Operations sections.

MarkLogic Retrieval API

• API Reference — Navigate the complete API reference.
• Definition Endpoint — Discover collections, filters, schemas, and vector capabilities with /v1/retrieve/definition.
• Retrieve Endpoint — Build text, vector, hybrid, and filtered searches with /v1/retrieve.
• Augment Endpoint — Retrieve complete document content by URI with /v1/retrieve/augment.
• Filters Guide — Construct Value, Word, Range, and View filters and combine them in search requests.
• Retrieve Config — Configure schemas, vector metadata, extraction paths, and search behavior in retrieveConfig.json.

MCP Server

This section is a technical reference for MarkLogic MCP Server behavior, request contracts, and runtime configuration.

• config.yaml Reference — Technical reference for config.yaml agent properties, mcp_auth, and workflow context parameters.
• Tool Contracts — Review the tools exposed to MCP clients, their inputs, and their outputs, including troubleshooting guidance.
• MCP Server Environment Variables — Look up supported runtime configuration variables and their effects.
• Authorization Header Behavior — Understand how authorization headers are accepted, forwarded, and handled.

Shared Terms

• Glossary — Find definitions for MarkLogic, MCP, Retrieval API, search, and deployment terminology.

For task-oriented procedures, see Operations. For architectural background, see Concepts.