Tana MCP Server

Implementation Reference

• src/server/tana-mcp-server.ts:469-497 (handler)

  Handler function that creates a plain Tana node under the target (default 'SCHEMA') with the supertag SYS_T01, effectively creating a new supertag.

  async ({ targetNodeId, name, description }) => {
    try {
      const node: TanaPlainNode = {
        name,
        description,
        supertags: [{ id: 'SYS_T01' }]
      };
  
      const result = await this.tanaClient.createNode(targetNodeId, node);
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(result, null, 2)
          }
        ],
        isError: false
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error creating supertag: ${error instanceof Error ? error.message : String(error)}`
          }
        ],
        isError: true
      };
    }

• src/server/tana-mcp-server.ts:464-467 (schema)

  Zod input schema defining parameters for the create_supertag tool.

  {
    targetNodeId: z.string().optional().default('SCHEMA'),
    name: z.string(),
    description: z.string().optional()

• src/server/tana-mcp-server.ts:462-498 (registration)

  Registration of the create_supertag tool on the MCP server using this.server.tool.

  this.server.tool(
    'create_supertag',
    {
      targetNodeId: z.string().optional().default('SCHEMA'),
      name: z.string(),
      description: z.string().optional()
    },
    async ({ targetNodeId, name, description }) => {
      try {
        const node: TanaPlainNode = {
          name,
          description,
          supertags: [{ id: 'SYS_T01' }]
        };
  
        const result = await this.tanaClient.createNode(targetNodeId, node);
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(result, null, 2)
            }
          ],
          isError: false
        };
      } catch (error) {
        return {
          content: [
            {
              type: 'text',
              text: `Error creating supertag: ${error instanceof Error ? error.message : String(error)}`
            }
          ],
          isError: true
        };
      }
    }