import { z } from "zod";
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import type { TransactionalApi } from "../api/transactional.js";
import type { NameResolver } from "../resolver.js";
// Cell write dimensions max: 21 per intersection (ls21)
export function registerTransactionalTools(server: McpServer, api: TransactionalApi, resolver: NameResolver) {
server.tool("read_cells", "Read cell data from a module view", {
workspaceId: z.string().describe("Anaplan workspace ID or name"),
modelId: z.string().describe("Anaplan model ID or name"),
moduleId: z.string().describe("Module ID or name"),
viewId: z.string().describe("Saved view ID or name"),
}, async ({ workspaceId, modelId, moduleId, viewId }) => {
const wId = await resolver.resolveWorkspace(workspaceId);
const mId = await resolver.resolveModel(wId, modelId);
const modId = await resolver.resolveModule(wId, mId, moduleId);
const vId = await resolver.resolveView(wId, mId, modId, viewId);
const data = await api.readCells(wId, mId, modId, vId);
return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
});
server.tool("write_cells", "Write values to specific cells in a module", {
workspaceId: z.string().describe("Anaplan workspace ID or name"),
modelId: z.string().describe("Anaplan model ID or name"),
moduleId: z.string().describe("Module ID or name"),
lineItemId: z.string().describe("Line item ID to write to"),
data: z.array(z.object({
dimensions: z.array(z.object({
dimensionId: z.string().describe("Dimension ID"),
itemId: z.string().describe("Item ID within the dimension"),
})).describe("Array of dimension coordinates"),
value: z.string().describe("Value to write"),
})).describe("Array of cell values to write"),
}, async ({ workspaceId, modelId, moduleId, lineItemId, data }) => {
const wId = await resolver.resolveWorkspace(workspaceId);
const mId = await resolver.resolveModel(wId, modelId);
const modId = await resolver.resolveModule(wId, mId, moduleId);
const result = await api.writeCells(wId, mId, modId, lineItemId, data);
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
});
server.tool("add_list_items", "Add new items to a list", {
workspaceId: z.string().describe("Anaplan workspace ID or name"),
modelId: z.string().describe("Anaplan model ID or name"),
listId: z.string().describe("List ID or name"),
items: z.array(z.object({
name: z.string().describe("Item name"),
code: z.string().optional().describe("Item code"),
properties: z.record(z.string(), z.string()).optional().describe("Item properties"),
})).describe("Items to add"),
}, async ({ workspaceId, modelId, listId, items }) => {
const wId = await resolver.resolveWorkspace(workspaceId);
const mId = await resolver.resolveModel(wId, modelId);
const lId = await resolver.resolveList(wId, mId, listId);
const result = await api.addListItems(wId, mId, lId, items);
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
});
server.tool("update_list_items", "Update existing items in a list", {
workspaceId: z.string().describe("Anaplan workspace ID or name"),
modelId: z.string().describe("Anaplan model ID or name"),
listId: z.string().describe("List ID or name"),
items: z.array(z.object({
id: z.string().describe("Item ID"),
name: z.string().optional().describe("New item name"),
code: z.string().optional().describe("New item code"),
properties: z.record(z.string(), z.string()).optional().describe("Updated properties"),
})).describe("Items to update"),
}, async ({ workspaceId, modelId, listId, items }) => {
const wId = await resolver.resolveWorkspace(workspaceId);
const mId = await resolver.resolveModel(wId, modelId);
const lId = await resolver.resolveList(wId, mId, listId);
const result = await api.updateListItems(wId, mId, lId, items);
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
});
server.tool("delete_list_items", "Remove items from a list", {
workspaceId: z.string().describe("Anaplan workspace ID or name"),
modelId: z.string().describe("Anaplan model ID or name"),
listId: z.string().describe("List ID or name"),
items: z.array(z.object({
id: z.string().describe("Item ID to delete"),
})).describe("Items to delete"),
}, async ({ workspaceId, modelId, listId, items }) => {
const wId = await resolver.resolveWorkspace(workspaceId);
const mId = await resolver.resolveModel(wId, modelId);
const lId = await resolver.resolveList(wId, mId, listId);
const result = await api.deleteListItems(wId, mId, lId, items);
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
});
}
