Skip to content

MCP server

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Aerospike Voyager includes an embedded Model Context Protocol (MCP) server that lets AI coding agents interact directly with your Aerospike clusters. Instead of guessing at schema or pasting documentation into chat, your AI agent can inspect and query the actual data.

Prerequisites

  • The MCP server started. See Setup.
  • You have at least one saved cluster connection.

How it runs

The MCP server is embedded in the Voyager app and reaches the connections you have saved there, so an agent sees the same clusters you are browsing. Turn it on from the MCP Server page. See Setup.

What can AI agents do through the MCP server?

When connected to Voyager’s MCP server, an AI coding agent can:

  • Browse cluster structure: summarize the cluster, and list namespaces, sets, and nodes with their stats.
  • Query and filter records: read records by key, run queries with filter expressions, and check record existence.
  • Create, update, and delete records: write new records, update bins, delete records, and truncate sets.
  • Manage connections: create, test, and switch between cluster connections.
  • Run info commands: issue Aerospike info protocol commands against the cluster or a specific node.

For the full list of available tools, see the Tool reference.

Access profiles

Voyager provides two access profiles that control which tools an AI coding agent may call:

  • Full Access: All tools are available. The agent can read, write, delete, manage connections, and run info commands.
  • Read Only: Browse and read operations only. Write, delete, and info commands are blocked at call time. execute_info and execute_info_on_node are blocked because the Aerospike info protocol supports mutation subcommands. Use this for safe exploration.

Switch profiles on the MCP Server page. The default is Full Access. See Access profiles.

Transport

The MCP server uses Streamable HTTP on localhost:9090 by default.

Both the port and the bind interface are configurable from the MCP Server page. The server does not start automatically with Voyager, so toggle it on from that page before connecting an agent. See Setup.

Authentication

Token-based authentication is optional and recommended. When enabled, your AI coding agent must include a Bearer token in the Authorization header. Voyager generates and stores the token for you.

Supported AI coding agents

Voyager works with any MCP-compatible agent. The MCP Server page in Voyager provides ready-to-copy setup snippets for:

  • Claude Code
  • OpenAI Codex CLI
  • Google Gemini CLI

Any editor or agent that supports the MCP Streamable HTTP transport (Cursor, VS Code, Claude Desktop, Windsurf, Zed) can also connect using the JSON configuration block shown on the MCP Server page.

Next steps