# MCP servers

> Generated field reference from the AQVEN Python package.

[Read in the browser](https://aqvenstudio.com/reference/mcp/)

<!-- Generated by tools/generate_reference.py. Do not edit this file by hand. -->

This reference is generated from the package's Pydantic models. Fields use their YAML aliases. Unknown fields are rejected. Cross-field rules implemented by validators may not appear in JSON Schema; run `aqven check` on a complete project.

## McpServerSpec

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `apiVersion` | `'aqven/v1'` | Yes | `—` | — |
| `kind` | `'McpServer'` | Yes | `—` | — |
| `description` | `string` | Yes | `—` | minLength=1 |
| `transport` | `'streamable_http'` | Yes | `—` | — |
| `url` | `string` | Yes | `—` | minLength=1 |
| `headers` | `SecretHeader[] \| null` | No | `None` | — |
| `schema_hash` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/McpServerSpec.json)

## SecretHeader

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `name` | `string` | Yes | `—` | minLength=1 |
| `value` | `string` | Yes | `—` | — |

[JSON Schema](/reference/schemas/SecretHeader.json)
