NoBrainner Protocol Docs

Remote MCP Server Specification

mcp.docs.intro

Supported Clients:
ChatGPTClaude ClaudeGemini GeminiGrok GrokCursor CursorWindsurf WindsurfVS Code VS Code

Endpoints & OAuth Metadata

Universal MCP Server Endpoint
1https://app.nobrainner.xyz/api/mcp
ChatGPT Compatible Gateway
1https://app.nobrainner.xyz/api/chatgpt/mcp
OAuth Protected Resource Metadata
1https://app.nobrainner.xyz/.well-known/oauth-protected-resource

ChatGPT Integration Visuals

Visual walkthrough for connecting NoBrainner inside ChatGPT via Remote MCP / Plugin:

1ChatGPT plugin tutorial step 1
2ChatGPT plugin tutorial step 2
3ChatGPT plugin tutorial step 3
4ChatGPT plugin tutorial step 4
5ChatGPT plugin tutorial step 5
6ChatGPT plugin tutorial step 6
7ChatGPT plugin tutorial step 7

1/7Follow each screenshot to install the NoBrainner ChatGPT plugin step by step.

Grok Grok (xAI) Integration Visuals

Visual walkthrough for connecting NoBrainner inside Grok via Custom Connector:

1Grok MCP connector tutorial step 1
2Grok MCP connector tutorial step 2
3Grok MCP connector tutorial step 3

1/3Follow each screenshot to connect NoBrainner to Grok step by step.

Gemini Gemini Spark Integration Visuals

Visual reference of NoBrainner connected inside Google Gemini Spark via Remote MCP:

Gemini Spark NoBrainner Connected AppGemini Spark Add Custom MCP ServerGemini Spark Available MCP Actions

Claude Claude.ai Web Integration Visuals

Visual reference of NoBrainner connected inside Anthropic Claude.ai via Remote MCP:

Claude AI NoBrainner Custom ConnectorClaude AI Add Custom Connector Setup

What to Ask Your AI Assistant

Once connected, try these prompts in any language:

Check study status

How many cards do I have to review today on NoBrainner? What is my current streak?

Find weak cards

Which cards am I struggling with most in my Spanish deck?

Browse community decks

Find popular French community decks on NoBrainner.

Import shared deck link

Import this shared deck link into my account: https://nobrainner.xyz/share/ownerUid:deckFingerprint

Create a deck with audio

Create a 20-card B2 French vocabulary deck and add standard audio.

Create a deck with Pro voice

Create a 15-card English phrasal verbs deck with a premium female voice.

Update deck settings

Set my Phrasal Verbs deck to show cards reversed and limit to 10 new cards per day.

Check accuracy & stats

What is my accuracy rate this month? Show me my grade breakdown.

Check leaderboard rank

Where do I rank on the global NoBrainner leaderboard this week?

List my decks

List all my active decks with their card counts.

Ask about voice options

What voices are available for my plan? Can I use human-like voices?

Get support

I have a question about NoBrainner — where can I get help?

Available Tools

get_student_overview

Returns profile overview, plan, available voice tiers, current streak, deck counts, and recent review metrics.

study.read, deck.read
get_user_stats

Returns detailed learning stats: accuracy rate, grade distribution, study hours, and 30-day accuracy history.

study.read, deck.read
get_leaderboards

Returns current global weekly leaderboard rankings, streak leaders, and user position.

study.read
get_deck_list

Returns list of student decks with card counts, sync status, and study settings.

deck.read
get_deck_detail

Returns detailed deck metadata and paginated card fronts/backs.

deck.read
get_deck_folders

Returns all student deck folders and decks grouped by folder, including custom emojis, colors, and sort order.

deck.read
create_folder

Creates a new deck organization folder with name and custom accent color.

deck.write
update_folder

Renames or changes accent color of an existing deck folder.

deck.write
delete_folder

Deletes a deck folder and moves contained decks back to root (unfoldered).

deck.write
move_deck_to_folder

Moves a deck into a specific folder or out to root (unfoldered).

deck.write
customize_deck

Customizes deck title, custom icon emoji, accent color, or display order position.

deck.write
get_weak_cards

Returns cards with highest struggle (Again/Hard) signals.

study.read, deck.read
get_review_timeline

Returns daily review activity and XP for the last N days.

study.read
create_deck_draft

Creates a pending flashcard deck draft from model output. Supports optional TTS audio (standard for free, human-like Chirp3-HD for Pro).

deck.write
preview_deck_draft

Previews a pending deck draft before saving.

deck.write
save_deck_draft

Saves a confirmed deck draft to the user account.

deck.write
get_deck_settings

Returns current study settings for a deck: orientation, daily limits, font, and auto-audio.

deck.read
update_deck_settings

Updates study settings for a deck: orientation, daily limits, font size, font family, or auto-audio.

deck.write

Legal Terms & Consent

"By connecting to the NoBrainner Remote MCP Server, you agree to our Terms of Service and Privacy Policy. Your client receives scoped access based on your authorization: read-only access for study statistics and deck browsing, and write access for creating flashcard drafts. Deck drafts are only saved after your explicit confirmation."

Frequently Asked Questions (FAQ)

Everything non-technical users need to know about connecting NoBrainner to AI assistants:

Q: Does Remote MCP work on free AI plans or do I need a paid subscription?

It depends on the platform: Claude.ai Web and Claude Desktop support Remote MCP on FREE & Pro plans! However, platforms like ChatGPT and Gemini Spark currently require a paid tier (Plus/Pro/Advanced) to connect custom MCP servers. Developer IDEs (Cursor, Windsurf) require their respective IDE plan.

Q: Can I connect and study from my phone / mobile device?

Yes! Once you link NoBrainner on Claude.ai or ChatGPT, your connection automatically syncs across your account. You can create decks and ask study questions right from your iPhone or Android phone.

Q: Do I need a computer to set this up?

No computer required! You can complete the 60-second setup directly from your phone browser or computer browser without downloading any files.

Q: Do I need to install any software or extensions?

No installation needed! NoBrainner operates a Remote Cloud MCP Server (https://app.nobrainner.xyz/api/mcp) that connects securely over the internet.

Q: Are my flashcards and study streak automatically saved?

Yes! Every flashcard deck created or modified by your AI assistant is instantly saved to your official NoBrainner account.