Skip to content

IDE Integration (MCP)

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI-powered IDEs and tools to securely connect to external services. DojoCode provides an MCP server that lets you interact with the platform directly from your favourite IDE.

With the DojoCode MCP integration you can:

  • Browse and search challenges — filter by language, difficulty, tags, and more
  • Create and edit challenges — write challenge descriptions, initial code, tests, and solutions
  • Run code and tests — execute your code and run test suites without leaving your IDE
  • Manage contests — view, create, and join contests
  • Download challenges — export challenge files as ZIP archives

Supported IDEs

DojoCode MCP works with any IDE or tool that supports the MCP protocol, including:

  • Claude Code (Anthropic)
  • Cursor
  • VS Code (with GitHub Copilot or compatible extensions)
  • Gemini CLI (Google)
  • Windsurf
  • Any MCP-compatible client

Getting Started

Before configuring your IDE, clone the starter repository. This repo contains the MCP configuration and project structure needed to work with DojoCode challenges:

bash
git clone https://bitbucket.org/sebastian_lucaciu/ai-code-challenge-curation-starter.git
cd ai-code-challenge-curation-starter
npm install

Then open this project in your IDE and follow the setup guide for your specific IDE below.

How It Works

  1. You clone the starter repository and open it in your IDE
  2. The repository includes the MCP server configuration for DojoCode
  3. On first connection, your IDE opens a browser window for authentication
  4. You log in to DojoCode and authorize the IDE
  5. The IDE receives an access token and can now interact with DojoCode on your behalf
  6. The token is valid for 90 days — after that, you simply re-authorize

Your credentials are never shared with the IDE. Authentication uses the industry-standard OAuth 2.1 protocol with PKCE.

Available Tools

Once connected, your IDE will have access to the following tools:

ToolDescription
get_challengesBrowse and search coding challenges with filters
get_challengeGet detailed info about a specific challenge
get_challenge_edit_dataGet challenge edit data for a specific variation
get_challenges_by_tagsFind challenges filtered by tags
get_all_tagsList all available challenge tags
get_templatesList available project templates
get_languagesList supported programming languages
create_challengeCreate a new coding challenge
add_variationAdd a language variation to a challenge
update_challenge_filesUpdate challenge source files
update_challenge_infoUpdate challenge metadata
check_slug_uniquenessVerify a challenge slug is unique
run_initial_testsRun sample tests for a challenge
run_all_testsRun the full test suite
run_challenge_codeExecute code for a challenge
download_challenge_zipDownload challenge files as ZIP
get_contestsBrowse available contests
get_upcoming_contestsList upcoming contests
get_contestGet detailed contest information
create_contestCreate a new contest
join_contestJoin an existing contest
get_contest_leaderboardView contest leaderboard

Quick Tip: /mcp Command

Most AI-powered IDEs support a /mcp command that lets you manage MCP server connections. After configuring the DojoCode server, you can type /mcp in your IDE's chat or command palette to:

  • View the status of connected MCP servers
  • Trigger authentication or re-authentication
  • Reconnect if the server was disconnected

This is the fastest way to verify your connection and troubleshoot issues.

Next Steps

Follow the setup guide for your IDE: