Use Akukallos from your AI assistant

How it works

• Your API key is the only login the assistant uses. It never sees your password.
• The key only allows making things and reading your balance. The assistant can create images, videos, speech and songs, and check your credits and recent creations. It cannot buy credits, change your account, or create other keys.
• Your credits pay for everything, up to the daily limit you set on the key.
• Nothing is stored on the MCP server. Your key is passed straight through with each request.

Set up in 3 steps

1. Create an API key

   Log in at akukallos.store, open the ⋮ menu at the top right and tap 🔑 API keys. Type a name, choose a daily limit, and tap Create key.

   • Copy the key straight away. It is shown only once. It starts with ak_live_.
   • Daily limit is the most credits this key can spend each day. It starts at 500,000 and you can set anything from 1,000 to 100,000,000. Change it later with the Limit button.
   • Use one key per app, such as "Claude Code" or "Cursor". You can have up to 5 active keys, and revoking one doesn't affect the others.

   Treat your key like a password. Anyone who has it can spend your credits, up to its daily limit. Never post it in a chat, a screenshot or a public repository. If it leaks, tap Revoke and create a new one.

2. Connect your AI app

   Pick your app. Replace ak_live_YOUR_KEY with the key you copied.

   Claude Code Cursor VS Code Claude Desktop Other apps

   Run this in your terminal (PowerShell, Terminal or Command Prompt):

   TerminalCopy

   claude mcp add --transport http akukallos https://mcp.akukallos.store/mcp --header "Authorization: Bearer ak_live_YOUR_KEY"

   Then check it with claude mcp list, or type /mcp inside Claude Code. To use Akukallos in every project, add --scope user before the name.

   Open ~/.cursor/mcp.json (all projects) or .cursor/mcp.json inside one project, or use Cursor Settings → MCP → add a server. Add:

   mcp.jsonCopy

   {
     "mcpServers": {
       "akukallos": {
         "url": "https://mcp.akukallos.store/mcp",
         "headers": {
           "Authorization": "Bearer ak_live_YOUR_KEY"
         }
       }
     }
   }

   Save, then refresh the MCP list in Cursor's settings. Akukallos should show a list of tools.

   Create .vscode/mcp.json in your project:

   .vscode/mcp.jsonCopy

   {
     "servers": {
       "akukallos": {
         "type": "http",
         "url": "https://mcp.akukallos.store/mcp",
         "headers": {
           "Authorization": "Bearer ak_live_YOUR_KEY"
         }
       }
     }
   }

   Save the file, then start the server from the small Start link that appears above it.

   Claude Desktop needs a small helper called mcp-remote, which requires Node.js. Open Claude Desktop's config file (Settings → Developer → Edit Config) and add:

   claude_desktop_config.jsonCopy

   {
     "mcpServers": {
       "akukallos": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://mcp.akukallos.store/mcp",
           "--header",
           "Authorization:${AKUKALLOS_AUTH}"
         ],
         "env": {
           "AKUKALLOS_AUTH": "Bearer ak_live_YOUR_KEY"
         }
       }
     }
   }

   Save, then fully quit and reopen Claude Desktop. The key sits in the env block on purpose. It avoids a space-in-arguments problem on Windows.

   Any app that can connect to a remote MCP server and send a custom header will work. Give it these two things:

   Server address (Streamable HTTP)

   https://mcp.akukallos.store/mcp

   Header

   Authorization: Bearer ak_live_YOUR_KEY

   Not supported yet: apps that only offer a "sign in with your account" connector, such as the Claude website and phone app or ChatGPT. Akukallos uses API keys for now. We plan to add sign-in support later.

3. Ask your assistant

   Start a new chat and try:

   • "How many Akukallos credits do I have?"
   • "What does a video cost on Akukallos?"
   • "Make a square image of a lighthouse at sunset."
   • "Read this paragraph aloud in a female South African English voice."
   • "Write a short afrobeats song about Lagos traffic."
   • "Make a vertical 9:16 video of rain on a window, standard quality."

   For anything that costs credits, a good assistant tells you the price and asks before it starts.

What your assistant can do

You don't need to remember these names. Your assistant picks the right one. They're listed so you know exactly what a key can do.

Not available through a key yet: turning an uploaded image into a video, cloning a new voice, and making a cover from an uploaded song. Use the Akukallos website for those.

Prices

These are the prices when this page was written. Prices can change, so ask your assistant "What does it cost?" and it will read the current prices from Akukallos.

Stay in control

An assistant works fast, and sometimes it makes mistakes. These protections are built in so one mistake can't empty your account.

A daily limit on every key

Each key has its own daily limit. When the key reaches it, new requests are refused until the next day, which starts at 00:00 UTC, or until you raise the limit. You can change it any time from ⋮ → 🔑 API keys → Limit.

It won't charge you twice for the same request

If your assistant sends the identical request again within 15 minutes, Akukallos doesn't run it again. The assistant gets the earlier result and nothing new is charged. To get another version on purpose, ask for a different prompt or say "make another version".

If the connection drops, nothing is repeated blindly

If the connection breaks and it's unclear whether a request went through, the assistant is told to check your recent creations first instead of trying again.

Other limits

• A key can start up to 10 creations per minute.
• A key can have at most 5 videos, and at most 5 songs, in progress at the same time.
• If a video or song fails, the credits are refunded automatically.
• You can revoke a key at any moment, and it stops working immediately.

Example conversation

Troubleshooting

Still stuck? Message Akukallos support on Telegram.

Questions

For developers

You can use the server directly, without an AI app. It speaks MCP over Streamable HTTP. It is stateless: send a JSON-RPC message in a POST to /mcp. Replies come back as a server-sent event. GET requests return 405.

List the tools

curl -X POST https://mcp.akukallos.store/mcp \
  -H "Authorization: Bearer ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

On Windows PowerShell, save {"jsonrpc":"2.0","id":1,"method":"tools/list"} in a file called body.json, then run:

curl.exe -X POST https://mcp.akukallos.store/mcp -H "Authorization: Bearer ak_live_YOUR_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d "@body.json"

Call a tool

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": { "name": "get_credits", "arguments": {} }
}

Use the official SDK

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(
  new StreamableHTTPClientTransport(new URL("https://mcp.akukallos.store/mcp"), {
    requestInit: { headers: { Authorization: `Bearer ${process.env.AKUKALLOS_KEY}` } },
  })
);

const result = await client.callTool({ name: "get_credits", arguments: {} });
console.log(result.content);