# Motecloud MCP Server Distribution

This directory contains the public distribution metadata for the hosted
Motecloud MCP server.

## Registry Descriptor

`server.json` is the registry-ready descriptor for:

- name: `io.github.motecloud/motecloud-mcp-server`
- transport: Streamable HTTP
- endpoint: `https://motecloud.io/mcp`
- auth: OAuth 2.1 with PKCE and dynamic client registration

The descriptor follows the MCP Registry `server.json` format and is intended
for registries such as the official MCP Registry and downstream registries that
consume the same metadata, including GitHub MCP Registry surfaces.

## Public Discovery Endpoints

- MCP transport: `https://motecloud.io/mcp`
- OAuth metadata: `https://motecloud.io/.well-known/oauth-authorization-server`
- Protected resource metadata: `https://motecloud.io/.well-known/oauth-protected-resource/mcp`
- JWKS: `https://motecloud.io/.well-known/jwks.json`

## Publishing

The `release-mcp` workflow validates `server.json`, publishes a GitHub release,
and can be used as the source artifact for registry submissions.

Official registry publishing currently uses the MCP Registry publisher flow.
The expected namespace is GitHub-owned:

```sh
mcp-publisher publish packaging/mcp/server.json
```

The public distribution repository includes `.github/workflows/publish-mcp-registry.yml`,
which uses GitHub Actions OIDC:

```sh
gh workflow run publish-mcp-registry.yml --repo motecloud/motecloud-mcp-server
```

Manual publishing is also supported with an authenticated GitHub login that can
prove ownership of the `motecloud` organization.