# AI integration

Vilna ships a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that gives AI coding assistants direct access to the live API reference, endpoint details and documentation search. Instead of switching between your editor and a browser to look up a path or parameter, your assistant queries the current specification directly.

One endpoint, every client
6 tools exposed
Always-current spec
Docs search built in

## Connect your AI tool 

Any MCP client that speaks the Streamable HTTP transport connects to one URL:

https://docs.vilna.io/mcp

Pick your client for the exact setup:

Claude Code

One CLI command

Add the server with a single command, then type `/mcp` in the CLI to verify - Claude Code lists the available tools with their parameters.

```bash
claude mcp add --transport http vilna-docs https://docs.vilna.io/mcp
```

Cursor

mcp.json config

Open the command palette, run "Open MCP settings", then add a custom server to `mcp.json`:

```json
{
  "mcpServers": {
    "vilna-docs": { "url": "https://docs.vilna.io/mcp" }
  }
}
```

Save and confirm the connection in MCP settings.

VS Code

Command palette

Open the command palette (`Cmd+Shift+P` / `Ctrl+Shift+P`), run **MCP: Add Server** and choose **HTTP**.

Enter the URL `https://docs.vilna.io/mcp` and a name, `vilna-docs`.

Open Chat in **Agent** mode and select the Tools icon to confirm.

Claude Desktop

Remote connector

Open **Settings → Connectors**, choose **Add custom connector** and enter `https://docs.vilna.io/mcp`. Connect it and enable it in the conversation where you need it. Organization policies may control access; see [Claude's current connector instructions](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

Other tools

Streamable HTTP

Any client that supports the MCP Streamable HTTP transport can register `https://docs.vilna.io/mcp` as an HTTP server. No API key is required.

## Available tools 

Once connected, your assistant has six tools - five for API discovery, one for search:

| Tool | Parameters | Description |
|  --- | --- | --- |
| `list-apis` | `filter?` | Lists available APIs (Platform, Management) with descriptions |
| `get-endpoints` | `name` | All endpoints for an API, with descriptions |
| `get-endpoint-info` | `name`, `path`, `method` | Full endpoint detail - parameters, body, responses, examples |
| `get-security-schemes` | `name` | Authentication requirements for an API |
| `get-full-api-description` | `name` | The complete OpenAPI specification |
| `search` | `query` | Searches across all documentation |


## What this looks like in practice 

With the server connected, ask in plain language - click any prompt to copy it:

## Access scope 

The MCP server exposes public documentation. It does not provide access to your account data or perform account operations.