# TablePulse Board Game Recommender

> TablePulse Board Game Recommender is a paid API for AI agents from tablepulse.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

Returns ranked board game recommendations for a group based on player count, complexity, theme, playtime, budget, and ages, grounded in current web reviews and discussion.

## Facts

- Endpoint: GET https://tablepulse.vercel.app/api/table/recommend
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tablepulse-board-game-recommender-006e94ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JCzGK7uSLviRV7dVW26jT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tablepulse-board-game-recommender-006e94ea
```

Example prompt: We're having game night with 5 people — two are total beginners and the rest are experienced — can you recommend some board games that fit a fantasy or adventure theme, take under 90 minutes, and stay under $50?

## When to prefer this

Use this endpoint when you need personalized board game recommendations for a specific group profile and want results grounded in current web sentiment and reviews rather than static database rankings. Prefer this over generic game databases when the group's composition (mixed skill levels, age range, budget constraints) matters and you want honest avoid-list guidance alongside positive picks.

## Known failure modes

- Group profile too vague or contradictory (e.g., complexity tolerance conflicts with player ages) leading to generic recommendations
- No strong matches found for highly specific combined constraints
- Payment not processed or insufficient USDC balance resulting in 402 error
- Web review sources temporarily unavailable causing stale or incomplete grounding
- Extremely niche theme requests may yield very short shortlists

## How this service works

Board-game recommendations by group profile — player count, complexity tolerance, theme, playtime, budget, and ages, grounded in current web reviews/discussion (never BoardGameGeek data). Returns a ranked shortlist with fit reasoning, honorable mentions, and honest avoid-list.

## Output

A ranked shortlist of board game recommendations with fit reasoning explaining why each game suits the group profile, honorable mention alternatives, and an avoid-list of games that would be a poor fit — all grounded in current web reviews and discussion rather than BoardGameGeek data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "ages": {
       "type": "string",
       "description": "8+ | adults only (optional)"
      },
      "lang": {
       "type": "string",
       "description": "en | de | fr | es | it | ja | pt | ar"
      },
      "budget": {
       "type": "string",
       "description": "$40 | under $60 (optional)"
      },
      "themes": {
       "type": "string",
       "description": "optional"
      },
      "player_count": {
       "type": "string",
       "description": "3-4 | 2 | 6+ (required — how many will play)"
      },
      "playtime_minutes": {
       "type": "string",
       "description": "45 | 90 (optional)"
      },
      "complexity_tolerance": {
       "type": "string",
       "description": "light | medium | heavy (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "errors": {
     "type": "object",
     "description": "Documented error responses, keyed by HTTP status code",
     "additionalProperties": {
      "type": "object",
      "required": [
       "description"
      ],
      "properties": {
       "example": {
        "type": "object"
       },
       "description": {
        "type": "string"
       }
      }
     }
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "summary": "A short, actionable pick for this group.",
  "recommendations": [
   {
    "title": "Example Game",
    "why_fit": "Fits a light-complexity 3-4 player group",
    "complexity_estimate": "medium-light"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tablepulse-board-game-recommender-006e94ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tablepulse.vercel.app](https://www.zero.xyz/host/tablepulse.vercel.app/llms.txt)