revenue-mcp

Instructions

Implementation Reference

• src/index.ts:510-530 (handler)

  The handler for the 'agent_inbox' tool, which filters pending messages for a specific agent (or 'ALL'), returns them, and removes them from the database.

  case "agent_inbox": {
    const db = loadDB();
    const agent = (args as any).agent;
    const messages = db.messages.filter(
      (m) => m.to === agent || m.to === "ALL"
    );
    if (messages.length === 0) {
      return { content: [{ type: "text", text: `No messages for ${agent}` }] };
    }
    // Remove read messages
    db.messages = db.messages.filter(
      (m) => m.to !== agent && m.to !== "ALL"
    );
    saveDB(db);
    return {
      content: [{
        type: "text",
        text: `INBOX for ${agent} (${messages.length} messages):\n\n${messages.map((m) => `[${m.priority.toUpperCase()}] ${m.from} → ${m.type}: ${m.content}\n  ${m.timestamp}`).join("\n\n")}`,
      }],
    };
  }

• src/index.ts:348-357 (registration)

  Registration of the 'agent_inbox' tool in the tool list provided by the MCP server.

    name: "agent_inbox",
    description: "Read pending messages for an agent",
    inputSchema: {
      type: "object" as const,
      required: ["agent"],
      properties: {
        agent: { type: "string", description: "Agent name to check inbox for" },
      },
    },
  },