Akua MCP Server

The Akua Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop and Claude Code, to interact directly with your Akua API and documentation.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Akua MCP server provides AI agents with:

Direct API access to Akua functionality
Documentation search capabilities
Real-time data from your Akua account
Code generation assistance for Akua integrations

Akua MCP Server Setup

Akua hosts a remote MCP server at https://api.akua.la/agent-gateway/public/runtime/technical_doc. Configure your AI development tools to connect to this server. If your APIs require authentication, you can pass in headers via query parameters or however headers are configured in your MCP client.

Claude Code

Scope Options

You can choose where you want this server to be available:

Local to the current project (default):

claude mcp add --transport http akua-technical-doc https://api.akua.la/agent-gateway/public/runtime/technical_doc

Across all your projects (user scope):

claude mcp add --transport http akua-technical-doc --scope user https://api.akua.la/agent-gateway/public/runtime/technical_doc

Shared with your team (project scope):

claude mcp add --transport http akua-technical-doc --scope project https://api.akua.la/agent-gateway/public/runtime/technical_doc

Useful Commands

claude mcp list                      ,[object Object],
claude mcp get akua-technical-doc    ,[object Object],
claude mcp remove akua-technical-doc ,[object Object],

Cursor

Add to ~/.cursor/mcp.json:

[object Object],
  ,[object Object],[object Object], ,[object Object],
    ,[object Object],[object Object], ,[object Object],
      ,[object Object],[object Object], ,[object Object],[object Object],
      ,[object Object],[object Object], ,[object Object],
        ,[object Object],[object Object],
        ,[object Object],
      ,[object Object],
    ,[object Object],
  ,[object Object],
,[object Object],

Windsurf

Add to your Windsurf MCP configuration:

[object Object],
  ,[object Object],[object Object], ,[object Object],
    ,[object Object],[object Object], ,[object Object],
      ,[object Object],[object Object], ,[object Object],[object Object],
      ,[object Object],[object Object], ,[object Object],
        ,[object Object],[object Object],
        ,[object Object],
      ,[object Object],
    ,[object Object],
  ,[object Object],
,[object Object],

Claude Desktop

Add to your Claude Desktop MCP configuration (claude_desktop_config.json):

[object Object],
  ,[object Object],[object Object], ,[object Object],
    ,[object Object],[object Object], ,[object Object],
      ,[object Object],[object Object], ,[object Object],[object Object],
      ,[object Object],[object Object], ,[object Object],
    ,[object Object],
  ,[object Object],[object Object],
  ,[object Object],[object Object], ,[object Object],[object Object],
,[object Object],

Testing Your MCP Setup

Once configured, you can test your MCP server connection:

Open your AI editor (Cursor, Windsurf, Claude Code, etc.)
Start a new chat with the AI assistant
Ask about Akua - try questions like:
- "How do I [common use case]?"
- "Show me an example of [API functionality]"
- "Create a [integration type] using Akua"

The AI should now have access to your Akua account data and documentation through the MCP server.