The Akua Model Context Protocol (MCP) server enables AI-powered code editors like Cursor and Windsurf, plus general-purpose tools like Claude Desktop, 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                      # List all configured servers
claude mcp get akua-technical-doc    # View details for this server
claude mcp remove akua-technical-doc # Remove the server

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "akua-technical-doc": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.akua.la/agent-gateway/public/runtime/technical_doc"
      ]
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "akua-technical-doc": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.akua.la/agent-gateway/public/runtime/technical_doc"
      ]
    }
  }
}

Claude Desktop

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

{
  "servers": {
    "Akua Technical Docs": {
      "url": "https://api.akua.la/agent-gateway/public/runtime/technical_doc",
      "type": "http"
    }
  },
  "inputs": []
}

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.