Connect your AI to BoardRepo

Read-only access to search and read boards. Connecting covers the public library and your own boards, including private ones.

Let your agent set it up

Add the BoardRepo MCP server so you can search and read hardware boards for me.

It is a remote HTTP MCP server at https://boardrepo.com/mcp. It is read-only: search and read public KiCad and Altium boards, their BOMs, schematics, and 3D views. Auth is OAuth via dynamic client registration, so there is no API key or secret to set.

Run the right command for my MCP client, then start the OAuth sign-in and tell me once it is connected. For Claude Code that is:
claude mcp add --scope user --transport http boardrepo https://boardrepo.com/mcp

If that command is not recognized, use my client's own way of adding a remote or HTTP MCP server with that URL.

Paste it into Claude Code, Cursor, Codex, Gemini CLI, or any coding agent, and it adds BoardRepo and signs you in for you.

Or paste this URL, no client ID or secret neededhttps://boardrepo.com/mcp

ClaudeWeb + desktop

In Claude.ai or Claude Desktop, open Settings → Connectors → Add custom connector.
Name it BoardRepo, paste https://boardrepo.com/mcp, and click Add.
Click Connect, sign in to BoardRepo, and Allow on the read-only screen.
Ask it to search BoardRepo, or to read a board's schematic and BOM.

On a Team or Enterprise workspace, an Owner has to enable the connector first. Free plans are limited to one custom connector.

ChatGPTBetaWeb + desktop

On a paid ChatGPT plan, open Settings → Connectors(or Apps & Connectors) → Advanced and turn on Developer mode.
In Connectors, click Create, paste https://boardrepo.com/mcp as the MCP server URL, and set Authentication to OAuth.
Create it, complete the BoardRepo sign-in, then turn the connector on in a chat to use it.

Developer mode is a beta feature on paid plans; on Business, Enterprise, and Edu an admin has to allow it. BoardRepo works as a chat connector. It will not show up as a Deep Research source, because it does not expose ChatGPT's search and fetch tools.

CursorIDE

One click to add it, then approve the sign-in:

Add BoardRepo to Cursor

Or add it manually to ~/.cursor/mcp.json and click Loginwhen Cursor shows "Needs login":

{
  "mcpServers": {
    "boardrepo": { "url": "https://boardrepo.com/mcp" }
  }
}

Claude CodeCLI

Run this once, then run /mcp and approve the browser sign-in:

claude mcp add --scope user --transport http boardrepo https://boardrepo.com/mcp

The prompts show up as slash commands, for example /mcp__boardrepo__analyze_board. Drop --scope user to add it to the current project only.

VS Code (Copilot)IDE

One click to add it (opens VS Code), then Allow the sign-in:

Add BoardRepo to VS Code

Or add it manually:

Command Palette → MCP: Add Server → HTTP, paste https://boardrepo.com/mcp, name it, and choose Global or Workspace.
Start the server and Allow the sign-in. It writes:

{
  "servers": {
    "boardrepo": { "type": "http", "url": "https://boardrepo.com/mcp" }
  }
}

In Chat, switch to Agent mode and enable the BoardRepo tools.

Needs GitHub Copilot. An organization policy can disable MCP.

Gemini CLICLI

Add it, then approve the sign-in in the browser:

gemini mcp add --transport http boardrepo https://boardrepo.com/mcp

Or add it to ~/.gemini/settings.json (use httpUrl, not url, for streaming HTTP):

{
  "mcpServers": {
    "boardrepo": {
      "httpUrl": "https://boardrepo.com/mcp",
      "authProviderType": "dynamic_discovery"
    }
  }
}

Gemini appUS onlyWeb

At gemini.google.com, open Settings & help → Connected Apps→ Add a custom app.
Paste https://boardrepo.com/mcp, continue, and approve the sign-in.

Currently limited to personal Google accounts, ages 18+, in the US, with Activity on.

OpenAI CodexCLI

Add the server, then start the OAuth login:

codex mcp add boardrepo --url https://boardrepo.com/mcp
codex mcp login boardrepo

Remote MCP over OAuth is recent in Codex. If codex mcp add or codex mcp login is not recognized, update Codex (check codex --version).

WindsurfIDE

Add it in Settings → Cascade → MCP Servers → Add custom server, or edit ~/.codeium/windsurf/mcp_config.json (Windsurf uses serverUrl):

{
  "mcpServers": {
    "boardrepo": { "serverUrl": "https://boardrepo.com/mcp" }
  }
}

If Windsurf does not open the BoardRepo sign-in, update Windsurf. Do not enter your BoardRepo password.

Any other MCP clientMCP

BoardRepo is a standard remote MCP server (Streamable HTTP) at https://boardrepo.com/mcp. Any MCP client that supports Streamable HTTP and OAuth dynamic client registration can connect with just this URL.

Prefer to browse first? Head to the board library.