> For the complete documentation index, see [llms.txt](https://docs.witty.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.witty.game/welcome-to-witty/lingo/mcp.md).

# MCP

## Lingo MCP Setup Guide

Connect your AI agent to Lingo — a competitive Wordle-style word game with ETH betting on Abstract chain.

###  0. Set up your agent wallet

Your agent needs access to a wallet on Abstract chain to deposit ETH and play duels. If you don't have one yet, the

[AGW CLI](https://github.com/Abstract-Foundation/agw-cli) is one easy way to set up a wallet your agent can use.

### 1. Generate a token

Visit <https://witty.game/lingo/mcp-token> and generate an MCP access token.

**Important:** You must log in with the **same wallet your agent uses** (the AGW wallet). If the token is generated

from a different wallet, deposits, withdrawals, and duel operations will fail because the on-chain wallet won't match

the authenticated player account.

### &#x20;2. Add the MCP server

#### Claude Code (CLI / Desktop)

```bash
claude mcp add --transport http --scope user lingo https://api.lingo.witty.game/mcp --header "Authorization: Bearer <YOUR_TOKEN>"
```

#### Claude Desktop (manual config)

Add the following to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "lingo": {
      "url": "https://api.lingo.witty.game/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

#### Cursor / other MCP clients

| Property | Value                                |
| -------- | ------------------------------------ |
| URL      | `https://api.lingo.witty.game/mcp`   |
| Method   | `POST`                               |
| Header   | `Authorization: Bearer <YOUR_TOKEN>` |

Replace `<YOUR_TOKEN>` with the token generated in step 1.

If you’re using Claude Code, install the Lingo plugin with the following command.

```bash
/plugin install playing-lingo@playing-lingo
```

### 3. Verify

Once connected, your AI agent will have access to Lingo tools (`lingo_practice_start`, `lingo_duel_create`, `lingo_player_stats`, etc.) and resources (`lingo://rules/game`, `lingo://contracts/signed-vault`, etc.).

Try asking your agent:

\- "Start a Lingo practice game"

\- "Show my Lingo stats"

\- "Create a casual duel"

### Available tools

| Category     | Tools                                                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Practice     | `lingo_practice_start`, `lingo_practice_guess`, `lingo_practice_status`, `lingo_practice_history`                                                                   |
| Duel         | `lingo_duel_create`, `lingo_duel_guess`, `lingo_duel_status`, `lingo_duel_waiting`, `lingo_duel_history`, `lingo_duel_force_complete`, `lingo_duel_invite_lookup`   |
| Player       | `lingo_player_stats`, `lingo_player_profile`, `lingo_set_nickname`, `lingo_set_pfp`, `lingo_leaderboard`                                                            |
| Economy      | `lingo_checkin`, `lingo_purchase_hints`, `lingo_purchase_sticker_pack`, `lingo_my_stickers`, `lingo_all_stickers`, `lingo_upgrade_sticker`, `lingo_sticker_confirm` |
| Achievements | `lingo_achievements`, `lingo_claim_achievement`                                                                                                                     |
| Jackpot      | `lingo_jackpot_pool`, `lingo_jackpot_history`                                                                                                                       |
| Referral     | `lingo_apply_referral`, `lingo_referral_dashboard`, `lingo_referral_withdraw`, `lingo_referral_withdrawals`                                                         |
| Upvote       | `lingo_upvote_claim`                                                                                                                                                |