Logo

Use an AI assistant

Connect an assistant such as ChatGPT or Claude to turn your description into a replay in your binked account. The connection uses MCP, the standard that lets an assistant use tools in another app.

  1. 1. Connect

    Add binked to your assistant once and sign in.

  2. 2. Describe

    Tell the hand in your own words or paste your notes.

  3. 3. Preview & publish

    Check the replay in chat, then publish it to get a link.

Connect with binked Sign-In (Recommended)

Use OAuth sign-in when your assistant supports it. You approve access on binked and do not need to create or copy a personal token.

  1. Open your assistant's connection settings.
    • ChatGPT: enable Settings → Security and login → Developer mode, then open Plugins and select +.
    • Claude: open Customize → Connectors, then + → Add custom connector.
  2. Name the connector binked and enter this server URL:
    https://api.binked.app/mcp
    In Claude, leave the optional OAuth Client ID and Client Secret fields empty.
  3. Create the connection and follow the sign-in prompts. In Claude, choose Connect after adding the connector. Sign in to the binked account where you want your hands saved.
  4. Review the app name and permissions on binked, then select Connect to return to your assistant.
  5. Enable binked in your conversation.
    • ChatGPT: start a new chat and add binked from the tools menu.
    • Claude: use the chat's + → Connectors menu.

Setup options depend on your account and workspace permissions. For current setup screens and availability, see OpenAI's ChatGPT connection guide and Claude's custom connector guide. Other clients need to support binked's MCP authorization flow; see the technical connection reference if sign-in is unavailable.

Describe, Preview, Then Publish

Include the game variant, blinds and any antes or straddles, player positions, starting stacks, known hole cards, and actions on each street. At showdown, say who showed or mucked. For multiple runouts, give each board.

Try this complete example:

Preview this hand in binked without publishing it: heads-up no-limit hold'em, blinds 1/2, both players start with 100 chips. I'm on the button/small blind with As Kd. I raise to 6 total and the big blind folds. Title: Button takes it down. Ask me about anything missing.

Shorthand notes work too. Paste them the way you wrote them down; the assistant asks about anything it still needs, such as the other players' stacks.

Preview this hand in binked: Live 1/3 NLH, 7-handed, ~500 stacks I open QsQc to 15 in the CO BTN calls, blinds fold Flop: Jd7s2c I bet 20, V calls Turn: 5h I bet 55, V calls River: Kd I check, V bets 120, I call V shows KhJh

Check positions, stacks, cards and bet amounts in the preview. ChatGPT, Claude and other clients that support interactive MCP apps can show a playable replay in chat; other clients return text. A preview is not saved and has no public replay link.

When it is correct, ask:

Publish this hand to binked and give me the replay link.

The saved hand appears in Hands.

Published replays are public and cannot be edited, so make corrections before publishing.

The assistant may ask follow-up questions because binked requires a complete, valid hand. Unknown hole cards can stay unknown when they are not needed to determine the result; missing actions or required showdown cards need to be supplied.

Ask for a Video

After publishing, ask:

Create a portrait video of this hand.

If you granted video access, the assistant starts the render and gives you a binked export-page link. Open it while signed in to the same account to check progress and download or share the MP4. Rendering takes a few minutes. The usual video formats and limits apply.

Manage Your Assistant's Access

The approval page lists the access requested: validating and publishing hands, starting video renders, or both.

Open Settings → AI agents to see connected apps and their permissions. Select Disconnect to revoke a connection. This does not remove replays already published. Remove the connector in your assistant too if you no longer want to use it. Unused connections expire after 90 days.

If Something Does Not Work

  • No binked tools in chat: check the server URL, finish sign-in, and enable the connector in the conversation.
  • The assistant answers without using binked: enable binked in this conversation and try “Use binked to preview this poker hand,” followed by the hand details. In ChatGPT, refresh the binked connection under Plugins after tool updates, then start a new chat and add binked from the tools menu. A request without hand details may need follow-up questions before a preview can be created.
  • Sign-in fails or the connection expired: start a fresh connection from your assistant. An old consent link may no longer be valid.
  • Hands work but video is unavailable: check the permissions under AI agents. If video access is missing, disconnect and reconnect, approving video access when requested.
  • The hand is rejected: review the missing details or inconsistent actions with your assistant, then ask for another preview.
  • Your client cannot use sign-in: use a personal token as described below.

Personal Tokens for Scripts and Other Clients

For the HTTP API or clients that cannot use OAuth, open Settings → AI agents and expand Personal access tokens · Advanced. Name and create a token, then copy it into your client's secret configuration. It is shown only once; do not paste it into chat. Tokens allow hand creation and video renders, expire after 90 days, and can be revoked on the same page.

The developer API reference contains configuration examples, hand schemas, tool details and limits.

Back to home