# Custom Apps

#### Overview

In addition to applications hosted in Natoma or by third-party providers, Natoma can also host your own, custom-developed applications. These can be:

1. A repository containing the source code for an MCP server
2. A remote URL specifying an MCP server
3. An API specification (from which to generate an MCP server)

This section describes the various mechanisms to provide access to custom apps in Natoma.

#### Requirements

1. The repository must be a publicly available repository hosted in GitHub or GitLab. At this time, Private repositories and other repository providers are not supported.
2. The MCP servers must support streamable HTTP, and the endpoint must end with “/mcp”
3. The API specification must adhere to OpenAPI Specification (“OAS”).

(Optional) The working directory for building and deploying the server should be provided, in case it is not the root directory of the repository. The build steps and deployment will happen from this provided folder path.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.natoma.ai/docs/custom-apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
