Theagora MCP Server

Instructions

Implementation Reference

• src/tools/selling.ts:158-170 (handler)

  The my_sales tool handler - executes when the tool is called, retrieves today's earnings from the API client and returns formatted JSON response

  // my_sales — View today's earnings
  server.tool(
    'my_sales',
    "Check how much you've earned today as a provider. Shows settled transactions and total revenue for the current day.",
    {},
    { readOnlyHint: true, openWorldHint: true },
    async () => {
      const result = await client.getEarnedToday();
      return {
        content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/tools/selling.ts:158-170 (registration)

  Tool registration for my_sales in the registerSellingTools function, defining the tool name, description, empty input schema, and hints

  // my_sales — View today's earnings
  server.tool(
    'my_sales',
    "Check how much you've earned today as a provider. Shows settled transactions and total revenue for the current day.",
    {},
    { readOnlyHint: true, openWorldHint: true },
    async () => {
      const result = await client.getEarnedToday();
      return {
        content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/client.ts:204-206 (helper)

  API client method getEarnedToday that makes HTTP GET request to /transactions/earned-today endpoint

  async getEarnedToday(): Promise<any> {
    return this.request('/transactions/earned-today');
  }

• src/tools/selling.ts:162-162 (schema)

  Empty input schema {} indicating the my_sales tool takes no parameters

  {},