registry/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Radoslav Dimitrov 3134575712
Add DELETE method to the OpenAPI specification (#782)
<!-- Provide a brief summary of your changes -->

## Motivation and Context
<!-- Why is this change needed? What problem does it solve? -->
The following adds a DELETE method to the reference API specification of
the registry.

The endpoint is consistent with the rest of the spec and provides a
standardised way for registry implementations to support deletion if
they choose to.

**Details:**
* Endpoint: DELETE /v0/servers/{serverName}/versions/{version}
* Uses tags: [publish] (same as POST /v0/publish for write operations)
* Requires security: bearerAuth authentication
* Returns ServerResponse on success (200) - matching POST pattern
* Same error responses: 401 (Unauthorized), 403 (Forbidden), 500
(Internal error)
* Added 404 (Not Found) for when server/version doesn't exist
* Parameters match the GET endpoint format with URL-encoding examples
* Marked as "(Optional)" in summary
* Explicit note that it's not implemented by the official registry
* States it's included for standardization purposes



## How Has This Been Tested?
<!-- Have you tested this in a real application? Which scenarios were
tested? -->

## Breaking Changes
<!-- Will users need to update their code or configurations? -->

## Types of changes
<!-- What types of changes does your code introduce? Put an `x` in all
the boxes that apply: -->
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update

## Checklist
<!-- Go over all the following points, and put an `x` in all the boxes
that apply. -->
- [ ] I have read the [MCP
Documentation](https://modelcontextprotocol.io)
- [ ] My code follows the repository's style guidelines
- [ ] New and existing tests pass locally
- [ ] I have added appropriate error handling
- [ ] I have added or updated documentation as needed

## Additional context
<!-- Add any other context, implementation notes, or design decisions
-->

---------

Signed-off-by: Radoslav Dimitrov <radoslav@stacklok.com>
2025-11-19 17:15:49 +02:00
..
administration Prepare docs for modelcontextprotocol.io (#728) 2025-11-18 17:22:31 +00:00
contributing Prepare docs for modelcontextprotocol.io (#728) 2025-11-18 17:22:31 +00:00
design Prepare docs for modelcontextprotocol.io (#728) 2025-11-18 17:22:31 +00:00
modelcontextprotocol-io Prepare docs for modelcontextprotocol.io (#728) 2025-11-18 17:22:31 +00:00
reference Add DELETE method to the OpenAPI specification (#782) 2025-11-19 17:15:49 +02:00
community-projects.md docs: Split community projects into sections, and add Java client (#758) 2025-11-10 12:36:58 +00:00
README.md Add community-projects reference document (#569) 2025-09-29 21:38:46 +01:00

MCP Registry Documentation

The MCP registry provides MCP clients with a list of MCP servers, like an app store for MCP servers.

I want to...

Documentation Index