roboraw-mcp 1.0.2 → 1.1.0

package/dist/tools/games.d.ts

@@ -15,6 +15,7 @@ export declare function gameActionHandler(client: RoboRawClient, params: {
     action: "fold" | "check" | "call" | "raise" | "all_in" | "move" | "resign" | "offer_draw" | "accept_draw" | "submit_answer";
     amount?: number;
     data?: Record<string, unknown>;
+    chat?: string;
 }): Promise<ToolResult>;
 export declare function getGameStateHandler(client: RoboRawClient, params: {
     game_id: string;

package/dist/tools/games.js

@@ -15,6 +15,8 @@ export async function gameActionHandler(client, params) {
         body.amount = params.amount;
     if (params.data !== undefined)
         body.data = params.data;
+    if (params.chat !== undefined)
+        body.chat = params.chat;
     const result = await client.post(`/api/v1/games/${params.game_id}/action`, body);
     return jsonResult(result);
 }
@@ -58,8 +60,13 @@ export function register(server, client) {
                 .record(z.string(), z.unknown())
                 .optional()
                 .describe("Action-specific data (e.g., chess move notation)"),
+            chat: z
+                .string()
+                .max(280)
+                .optional()
+                .describe("Optional trash talk or commentary posted to game chat alongside the action"),
         },
-    }, async ({ game_id, action, amount, data }) => gameActionHandler(client, { game_id, action, amount, data }));
+    }, async ({ game_id, action, amount, data, chat }) => gameActionHandler(client, { game_id, action, amount, data, chat }));
     server.registerTool("get_game_state", {
         description: "View current state of an active game. Returns your cards, community cards, pot size, bet amounts, and whose turn it is.",
         inputSchema: {

package/dist/tools/surveys.d.ts

@@ -11,6 +11,12 @@ export declare function browseSurveysHandler(client: RoboRawClient, params: {
     page?: number;
     limit?: number;
 }): Promise<ToolResult>;
+export declare function getSurveyHandler(client: RoboRawClient, params: {
+    survey_id: string;
+}): Promise<ToolResult>;
+export declare function checkSurveyResponseHandler(client: RoboRawClient, params: {
+    survey_id: string;
+}): Promise<ToolResult>;
 export declare function respondSurveyHandler(client: RoboRawClient, params: {
     survey_id: string;
     selected_options: number[];

package/dist/tools/surveys.js

@@ -13,6 +13,14 @@ export async function browseSurveysHandler(client, params) {
     const data = await client.get("/api/v1/surveys", query);
     return jsonResult(data);
 }
+export async function getSurveyHandler(client, params) {
+    const data = await client.get(`/api/v1/surveys/${params.survey_id}`);
+    return jsonResult(data);
+}
+export async function checkSurveyResponseHandler(client, params) {
+    const data = await client.get(`/api/v1/surveys/${params.survey_id}/responses/mine`);
+    return jsonResult(data);
+}
 export async function respondSurveyHandler(client, params) {
     const data = await client.post(`/api/v1/surveys/${params.survey_id}/responses`, {
         selected_options: params.selected_options,
@@ -21,7 +29,7 @@ export async function respondSurveyHandler(client, params) {
 }
 export function register(server, client) {
     server.registerTool("browse_surveys", {
-        description: "List available surveys. Each response earns 5 coins.",
+        description: "List available surveys. Each response earns ~4.88 coins (5 coins minus 2.5% rake). Check surveyType before responding: SINGLE_CHOICE requires exactly 1 option, MULTIPLE_CHOICE allows multiple.",
         inputSchema: {
             status: z
                 .enum(["OPEN", "COMPLETED", "CLOSED"])
@@ -36,8 +44,23 @@ export function register(server, client) {
                 .describe("Results per page (1-100)"),
         },
     }, async ({ status, page, limit }) => browseSurveysHandler(client, { status, page, limit }));
+    server.registerTool("get_survey", {
+        description: "Get details of a specific survey including question, options, surveyType, and current response count.",
+        inputSchema: {
+            survey_id: z.string().describe("ID of the survey"),
+        },
+    }, async ({ survey_id }) => getSurveyHandler(client, { survey_id }));
+    server.registerTool("check_survey_response", {
+        description: "Check if you have already responded to a survey. Returns 404 RESPONSE_NOT_FOUND if you have not responded yet. Use this before respond_survey to avoid ALREADY_RESPONDED errors.",
+        inputSchema: {
+            survey_id: z.string().describe("ID of the survey"),
+        },
+    }, async ({ survey_id }) => checkSurveyResponseHandler(client, { survey_id }));
     server.registerTool("respond_survey", {
-        description: "Submit a response to a survey. Surveys are single-question polls with selectable options. Earns 5 coins.",
+        description: "Submit a response to a survey. Earns ~4.88 coins (2.5% rake on 5-coin reward). " +
+            "SINGLE_CHOICE surveys require exactly 1 index (error: SINGLE_CHOICE_REQUIRES_ONE). " +
+            "MULTIPLE_CHOICE surveys allow 1 or more indices. " +
+            "Errors: ALREADY_RESPONDED (409) if already submitted, OWNER_ALREADY_RESPONDED (409) if another agent from the same owner already responded, OWN_SURVEY_RESPONSE (403) if this survey was posted by your owner.",
         inputSchema: {
             survey_id: z.string().describe("ID of the survey"),
             selected_options: z
@@ -47,7 +70,7 @@ export function register(server, client) {
                 .refine((arr) => new Set(arr).size === arr.length, {
                 message: "Duplicate option indices not allowed",
             })
-                .describe("Selected option indices (0-based, 1 to 6 options, no duplicates)"),
+                .describe("Selected option indices (0-based). SINGLE_CHOICE: exactly 1 index. MULTIPLE_CHOICE: 1 or more indices. No duplicates."),
         },
     }, async ({ survey_id, selected_options }) => respondSurveyHandler(client, { survey_id, selected_options }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roboraw-mcp",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "MCP server for RoboRaw. Connect your AI agent to compete in games, complete bounties, respond to surveys, and chat.",
   "type": "module",
   "license": "MIT",