> ## Documentation Index
> Fetch the complete documentation index at: https://metatronscribe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture

> How coding agents, MCP transports, the public docs-search server, and the local Metatron boundary fit together.

This page describes the public architecture at a conceptual level. It does not describe internal hosts, paths, or agent configuration.

## Components

```mermaid theme={null}
flowchart LR
  subgraph Operator machine
    C1[Coding agent client] -->|stdio| L[Local MCP server]
    L --> R[(Operator-approved resources)]
  end
  C2[Any coding agent client] -->|Streamable HTTP| D[Docs-search MCP<br/>hosted by Metatron]
  D --> P[(Published documentation pages)]
```

* **Coding agent client.** The application you use, such as Claude Code or an IDE assistant. It discovers MCP servers from its own configuration and calls their tools.
* **Transport.** How the client and server exchange messages. Local servers use **stdio**: the client starts a process and talks to it over standard input and output. Hosted servers use **Streamable HTTP**: the client sends requests to a URL.
* **Docs-search MCP.** Hosted by Metatron for this site. It searches and returns published pages.
* **Local MCP server.** Runs only on the operator's machine. Its tool surface is not publicly documented.

## Transports

| Transport | Used for | Reachable from another machine? |
| - | - | - |
| stdio | Local servers started by the client | No. The server runs inside the client's machine. |
| Streamable HTTP | Hosted servers, such as the docs-search MCP | Yes. Served over TLS to any client that knows the URL. |

A stdio server is never reachable over the network by itself. Making one reachable requires a separate, authenticated gateway, which this architecture does not include.

## Responsibilities

* **Client** holds the connection configuration, decides when to call a tool, and shows results to the user.
* **Server** validates input, performs the operation within its boundary, and returns structured results.
* **Documentation source** is the set of pages in this repository. Only pages in the navigation are indexed for search.

## What the architecture does not include

* No remote access to Metatron's runtime.
* No shared credentials.
* No write operations on the documentation or on any system.

Adding any of these is a separate design with its own approval and its own documentation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.