Clients

Adding Kalpana from the Claude directory

Both servers are listed in the Claude directory. This works in Claude on the web, Claude Desktop and the Claude mobile apps.

Or add a custom connector. Open Settings → Connectors → Add custom connector and enter the server URL:

https://mcp.kalpana.one/mcp/batch

Or use the Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows), then restart Claude Desktop:

{
  "mcpServers": {
    "kalpana-batch": {
      "url": "https://mcp.kalpana.one/mcp/batch"
    }
  }
}

Installing the Claude Code plugins

Add Kalpana's plugin marketplace, then install the plugin for each server you want:

/plugin marketplace add shreekaramtech/kalpana-agent
/plugin install kalpana-batch@kalpana
/plugin install kalpana-designer@kalpana

Each plugin adds the server and a skill for it. Run a command that uses it; your browser opens to sign in. To add a server without the plugin:

claude mcp add --transport http kalpana-batch https://mcp.kalpana.one/mcp/batch

Connecting in ChatGPT Developer Mode

ChatGPT connects to Kalpana using Client ID Metadata Documents (CIMD):

https://mcp.kalpana.one/mcp/batch

Configuring Cursor IDE

1. Open Cursor and navigate to Settings → Features → MCP Servers.
2. Click + Add New MCP Server.
3. Fill in the connection form:
   • Name: kalpana-batch
   • Type: http (or sse)
   • URL: https://mcp.kalpana.one/mcp/batch
4. Save the configuration and verify the status shows a green dot.

Using the Codex Agent Plugin

Kalpana's agent plugins are in the public kalpana-agent repository, one folder per server:

• plugins/kalpana-batch: the batch server at https://mcp.kalpana.one/mcp/batch and the create-creative-batch skill.
• plugins/kalpana-designer: the designer server at https://mcp.kalpana.one/mcp/designer and the design-a-template skill.

Each folder has the portable plugin.json and mcp.json and a .codex-plugin manifest. To validate one in your Codex environment:

python3 "$CODEX_HOME/skills/.system/plugin-creator/scripts/validate_plugin.py" \
  plugins/kalpana-batch

Installing the Gemini CLI extension

The kalpana-agent repository is also a Gemini CLI extension with both servers:

gemini extensions install https://github.com/shreekaramtech/kalpana-agent

Adding custom connectors in Grok

https://mcp.kalpana.one/mcp/batch
https://mcp.kalpana.one/mcp/designer

Asking Grok Bot to add Kalpana

Grok Bot is xAI's personal agent, separate from Grok on grok.com. It adds servers when you ask it in chat.

Add a custom MCP server called kalpana-batch at https://mcp.kalpana.one/mcp/batch
Add a custom MCP server called kalpana-designer at https://mcp.kalpana.one/mcp/designer

Adding the servers to Hermes Agent

Hermes finds the sign-in endpoints, registers itself and opens your browser:

hermes mcp add --url https://mcp.kalpana.one/mcp/batch --auth oauth kalpana-batch
hermes mcp add --url https://mcp.kalpana.one/mcp/designer --auth oauth kalpana-designer

Choose the workspace to share and approve. To check a server later, run hermes mcp test kalpana-designer. Hermes stores the token in ~/.hermes/mcp-tokens/, not in its config file.

Integrating with the TypeScript SDK

You can connect to Kalpana MCP directly from Node.js, Bun, or Deno using @modelcontextprotocol/sdk:

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

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.kalpana.one/mcp/batch"),
  {
    headers: {
      Authorization: `Bearer ${process.env.KALPANA_OAUTH_TOKEN}`,
    },
  }
);

const client = new Client(
  { name: "my-custom-agent", version: "1.0.0" },
  { capabilities: {} }
);

await client.connect(transport);

// List available tools
const tools = await client.listTools();
console.log("Tools:", tools);

// Call a tool
const workspace = await client.callTool({
  name: "get_workspace",
  arguments: {},
});
console.log("Workspace:", workspace);

Open Kalpana Designer in the Claude directory and select Connect, then sign in to Kalpana and approve access. The consent screen asks for the designer's permissions, which include creating and editing templates.

Or add a custom connector with the designer URL, or a second entry in claude_desktop_config.json (then restart Claude Desktop):

{
  "mcpServers": {
    "kalpana-batch": {
      "url": "https://mcp.kalpana.one/mcp/batch"
    },
    "kalpana-designer": {
      "url": "https://mcp.kalpana.one/mcp/designer"
    }
  }
}

In Developer mode, add another connector with the designer URL, then sign in to Kalpana and approve access. The consent screen asks for the designer's permissions, which include creating and editing templates.

Add another MCP server named kalpana-designer, of type http, with the URL https://mcp.kalpana.one/mcp/designer.

/plugin marketplace add shreekaramtech/kalpana-agent
/plugin install kalpana-designer@kalpana

Or add the server on its own:

claude mcp add --transport http kalpana-designer https://mcp.kalpana.one/mcp/designer

Run a command that uses it; your browser opens to sign in.