LNC Chessboard

By latenightbuilder

0+ active installationsVersion 1.4.0

Embed live chess.com and Lichess player profiles, plus interactive PGN game viewers with replay and analysis, via shortcode or block.

Description

LNC Chessboard is a WordPress plugin made for chess content creators and players.

Embed interactive, themed chess game boards and live Chess.com and Lichess player stats, using a shortcode or block.

Game Viewer & Analysis

Show chess games the modern way. Paste a PGN or upload a .pgn file, and your readers get an interactive board right in your post. They can step through the moves, click any move in the notation, or open the position in Lichess analysis.

  • Board themes: brown, blue, green, grey, and LNC purple, or pick your own square colours to match your site.
  • Positions too: set up a single position or paste a FEN, then draw arrows and highlight squares to explain an idea.
  • Autoplay: play through a game hands-free at slow, normal, or fast speed.
  • Clean embeds: hide the move list, buttons, or analysis links, and set the board size.
  • Keyboard friendly: arrow keys step through moves, with screen-reader announcements.
  • Save and reuse: store games under LNC Chessboard → Chess Games. Players, event, date, and result are read from the PGN.

Add a game with the Chess Game block, or with a shortcode:

[lncchess_game id="123"]
[lncchess_game pgn="1. e4 e5 2. Nf3 Nc6 3. Bb5 a6" theme="green"]

Player Profiles

Show any chess.com or Lichess player’s stats, fetched live so ratings are always current.

  • Stats dashboard (default): charts for win rate or activity by time control, ratings by format, results, and peak vs current rating, plus tiles for peak rating, total games, win rate, and FIDE.
  • Compact card: a small summary for sidebars. Add layout="card".
  • Dark and light themes.

chess.com profiles include ratings with peaks, results per time control, tactics, and Puzzle Rush. Lichess profiles include every time control, games per format, bio, online status, and playing time. Both use free public APIs, so no API key is needed.

Build a shortcode with a live preview under LNC Chessboard → Player Profiles, or write one yourself:

[lncchess_profile source="chesscom" username="hikaru"]
[lncchess_profile source="lichess" username="DrNykterstein" theme="light"]

Multilingual

Translated into German, French, Russian, Polish, Turkish, and Brazilian Portuguese. The plugin follows your site language under Settings → General. Chess terms such as Blitz, Rapid, PGN, and FIDE stay in English. You can help add your language on translate.wordpress.org.

AI / MCP: use your chess content from ChatGPT, Claude, and other AI assistants

LNC Chessboard is built for the Model Context Protocol (MCP), the open standard that popular AI clients such as ChatGPT, Claude, and Cursor use to connect to tools. Turn it on, and your AI assistant can work directly with the chess games saved on your site instead of guessing at shortcodes.

Ask your assistant things like:

  • “Save this PGN as a game and give me the block to put in my post.”
  • “Find my saved games against the Sicilian and list them.”
  • “Embed this position with the green board, flipped to Black’s side.”

The assistant gets four tools and two reference resources:

  • List and search saved games by title, player, or event.
  • Get a saved game with its PGN or FEN, players, result, and board settings.
  • Create a saved game or position from PGN or FEN. Players, event, date, and result are read from the PGN headers.
  • Build embed markup: a ready-to-paste [lncchess_game] shortcode and lncchess/game block for a saved game, an inline PGN, or a FEN position.
  • Attribute reference and display options resources, so the assistant always uses valid themes, sizes, colours, and settings.

How it works and what it needs:

  • Off by default. Turn it on under LNC Chessboard → AI / MCP.
  • Uses the Abilities API built into WordPress 6.9 and later.
  • Requires the free WordPress MCP Adapter plugin, installed separately. Connect your AI client through the adapter over HTTP or WP-CLI.
  • The assistant acts as the WordPress user it connects as, and only users who can edit posts can use the tools.
  • Creating a saved game is the only write action. No tool edits or deletes games. New games are saved as drafts unless the user may publish and asks for it.
  • The server does not check move legality. A game with illegal moves shows an invalid PGN message in the viewer.
  • Player profiles are not exposed, and the MCP tools make no requests to chess.com, Lichess, or any other service.

External APIs

LNC Chessboard connects to the following external services. The chess.com and Lichess connections are only made when a Player Profile shortcode is present on a page, or when a user previews a profile in the WordPress admin. The feedback connection is only made when an administrator submits the optional deactivation form.

1. chess.com Published Data API
* Service: chess.com
* URL: https://api.chess.com/pub/
* Purpose: Fetches public player profile data including username, avatar, title, ratings, win/loss/draw record, country, followers, and join date.
* Data sent: The chess.com username entered in the shortcode attribute. No personal data from your WordPress site or its visitors is transmitted.
* Authentication: None required. The chess.com Published Data API is fully public.
* Privacy Policy: https://www.chess.com/legal/privacy
* Terms of Service: https://www.chess.com/legal/user-agreement

2. Lichess Public API
* Service: Lichess (lichess.org)
* URL: https://lichess.org/api/
* Purpose: Fetches public player profile data including username, title, ratings across all time controls, win/loss/draw record, bio, FIDE rating, online status, playing time, and patron status.
* Data sent: The Lichess username entered in the shortcode attribute. No personal data from your WordPress site or its visitors is transmitted.
* Authentication: None required. The Lichess public API is free and open.
* Privacy Policy: https://lichess.org/privacy
* Terms of Service: https://lichess.org/terms-of-service

Caching: All profile API responses are cached on your WordPress server for 5 minutes using WordPress transients. This keeps your chess pages loading fast while ensuring data stays fresh.

3. Lichess Analysis / Import (Game Viewer)
* Service: Lichess (lichess.org)
* URL: https://lichess.org/analysis/ and https://lichess.org/import
* Purpose: Optional, user-initiated handoff from the Game Viewer. When a visitor clicks “Analyze this position” or “Open full game on Lichess”, their browser opens Lichess in a new tab with the current FEN or the game’s PGN.
* Data sent: Only the chess position (FEN) or game (PGN) being viewed, and only when the visitor clicks the button. These requests are made by the visitor’s browser, not your WordPress server. No automatic or background requests are made.
* Privacy Policy: https://lichess.org/privacy
* Terms of Service: https://lichess.org/terms-of-service

4. Deactivation feedback (Google Apps Script)
* Service: Google Apps Script, run by the Late Night Chess team, which saves responses to a private Google Sheet.
* URL: https://script.google.com/
* Purpose: When an administrator deactivates LNC Chessboard, an optional form asks why. Responses help us improve the plugin.
* Data sent: Only if the administrator clicks “Submit & Deactivate”: the chosen reason, the optional comment, the email address shown in the form (pre-filled with the administrator’s email, editable), the plugin name and version, and the site’s address (for example https://example.com). Nothing is sent when they click “Skip & Deactivate”, close the form, or use bulk deactivation. No visitor data is ever sent.
* Google Privacy Policy: https://policies.google.com/privacy
* Google Terms of Service: https://policies.google.com/terms

Bundled Libraries

LNC Chessboard bundles these open-source JavaScript libraries locally (no external CDN is used at runtime):

  • chess.js (BSD-2-Clause) — PGN parsing and chess rules. Loaded only on pages with a game viewer.
  • chessground (GPL-3.0-or-later) — the board UI developed for Lichess. Loaded only on pages with a game viewer.
  • Chart.js 4.6.1 (MIT) — the charts in the player stats dashboard. Loaded only on pages with a dashboard-layout player profile, and on the Player Profiles admin page for the live preview.

Privacy Policy

LNC Chessboard does not collect, store, or transmit any personal data about your WordPress site’s visitors.

When an administrator deactivates the plugin, an optional feedback form appears. If they choose to submit it, the selected reason, any comment they type, the email address shown in the form (pre-filled with their account email; they can change or clear it), the plugin version, and the site’s address are sent to the Late Night Chess team through Google Apps Script and stored in a private Google Sheet. Nothing is sent if they skip or close the form. The email is used only to follow up on the feedback.

When a Player Profile shortcode is rendered, LNC Chessboard makes a server-side request from your WordPress server to chess.com or Lichess. The only data sent to these external services is the chess username specified in the shortcode — no visitor IP addresses, cookies, or personal information are included in these requests.

Fetched profile data is stored temporarily in your WordPress database as a transient cache for up to 5 minutes, then automatically deleted and refreshed. This data is entirely public information sourced from the respective chess platform’s public API.

For more information on how chess.com and Lichess handle data, refer to their respective privacy policies linked in the External APIs section above.

The optional AI / MCP integration makes no external requests and sends no data to chess.com, Lichess, or any other third party. It sends the connected AI client only the responses of the tools that client calls, and only for a logged-in WordPress user who can edit posts.

Installation

  1. Upload the lnc-chessboard folder to /wp-content/plugins/, or install it from Plugins → Add New.
  2. Activate the plugin on the Plugins screen.
  3. Open LNC Chessboard in the admin menu. Add games under Chess Games, or build a profile shortcode under Player Profiles.

FAQ

Do I need an API key or an account?

No. The chess.com and Lichess APIs are free and public, and the Game Viewer runs entirely in the visitor’s browser.

Does it slow down my site?

No. Scripts and styles load only on pages that use a chess shortcode or block, and profile data is cached for 5 minutes.

How up to date is player data?

Within 5 minutes. After the cache expires, the next visit fetches fresh data.

Can I use the small card instead of the dashboard?

Yes. Add layout="card" to the shortcode, or pick it in the shortcode builder.

What PGN works?

Any standard PGN, including games that start from a custom position via a FEN header.

Which languages are supported?

English, German, French, Russian, Polish, Turkish, and Brazilian Portuguese. Your own post text and player bios from chess.com or Lichess are not translated.

Where can I get support or request a feature?

Use our contact form. We read every message.

Changelog

1.4.0

  • New: AI / MCP integration. AI clients such as ChatGPT and Claude can list, read, and create saved chess games and build board embeds through the WordPress MCP Adapter.
  • Off by default. Turn it on under LNC Chessboard → AI / MCP. Requires the separately installed MCP Adapter plugin.
  • LNC Chessboard now requires WordPress 6.9 or later.
  • Existing shortcodes, blocks, and player profiles are unchanged.

1.3.1

  • New optional feedback form when deactivating the plugin. It can always be skipped, and nothing is sent unless you submit it.
  • The feedback form is translated into German, French, Russian, Polish, Turkish, and Brazilian Portuguese.
  • Readme: documented the feedback form under External APIs and Privacy Policy.

1.3.0

  • Player Profiles: new stats dashboard with charts, now the default layout. Use layout="card" for the compact card.
  • chess.com profiles now include peak ratings, per-time-control records, FIDE rating, tactics, and Puzzle Rush scores.
  • Translations for German, French, Russian, Polish, Turkish, and Brazilian Portuguese.
  • Refreshed admin pages, and board coordinates now scale with the board size.
  • Bundles Chart.js 4.6.1 locally for the dashboard charts.
  • Input sanitisation and script-loading fixes from Plugin Check.

Older versions are listed in changelog.txt.