Twining MCP Server

Instructions

Implementation Reference

• src/tools/blackboard-tools.ts:158-164 (handler)

  The MCP tool handler for 'twining_recent', which invokes the engine's recent method.

  async (args) => {
    try {
      const result = await engine.recent(args.n, args.entry_types);
      return toolResult(result);
    } catch (e) {
      return toolError(
        e instanceof Error ? e.message : "Unknown error",

• src/engine/blackboard.ts:166-173 (handler)

  The 'recent' method in BlackboardEngine which retrieves the most recent blackboard entries.

  /** Get the N most recent entries, optionally filtered by type. */
  async recent(
    n?: number,
    entry_types?: string[],
  ): Promise<{ entries: BlackboardEntry[] }> {
    const entries = await this.store.recent(n, entry_types);
    return { entries };
  }

• src/tools/blackboard-tools.ts:142-157 (registration)

  The registration of the 'twining_recent' tool in the MCP server.

  server.registerTool(
    "twining_recent",
    {
      description:
        "Get the most recent blackboard entries. Quick way to see latest activity without specifying filters.",
      inputSchema: {
        n: z
          .number()
          .optional()
          .describe("Number of entries to return (default: 20)"),
        entry_types: z
          .array(z.string())
          .optional()
          .describe("Optional type filter"),
      },
    },