MCP Server for Claude

NeuralRepo exposes a remote MCP server that gives Claude direct access to your idea repository. Save, search, update, link, and delete ideas without ever leaving your conversation.

What Is MCP?

The Model Context Protocol is an open standard for connecting AI assistants to external tools and data. NeuralRepo implements an MCP server at:

https://neuralrepo.com/mcp/

When connected, Claude gains eight tools for managing your ideas. Authorization is handled through OAuth 2.0 with PKCE, so your data stays secure.

Setup

Claude.ai

1. Open Claude.ai and go to Settings > Integrations.

2. Click Add Remote MCP Server.

3. Paste the NeuralRepo MCP URL:

   https://neuralrepo.com/mcp/

4. Save. On your next conversation, Claude will have access to NeuralRepo tools.

5. The first time Claude uses a tool, you will be prompted to authorize via OAuth. Sign in with your NeuralRepo account to grant access.

Claude Desktop

Add the following to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "neuralrepo": {
      "transport": "http",
      "url": "https://neuralrepo.com/mcp/"
    }
  }
}

On macOS, this file is located at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, it is at %APPDATA%\Claude\claude_desktop_config.json.

Restart Claude Desktop after saving. The OAuth prompt appears on first tool use.

Claude Code

Run the following command in your terminal:

claude mcp add --transport http neuralrepo https://neuralrepo.com/mcp/

On the next Claude Code session, NeuralRepo tools are available. OAuth authorization triggers automatically on first use.

OAuth Flow

NeuralRepo uses OAuth 2.0 with PKCE (S256) for MCP authorization:

1. Claude attempts to call a NeuralRepo tool.
2. The MCP client initiates an authorization request with a PKCE code challenge.
3. You are redirected to the NeuralRepo consent screen where you sign in (GitHub, Google, Apple, or magic link).
4. You grant Claude the requested scopes: ideas:read and ideas:write.
5. NeuralRepo issues an access token and a refresh token (90-day expiry).
6. The MCP client stores the token and uses it for all subsequent requests.

Tip

You can revoke MCP access at any time from Settings > Connected Apps in the NeuralRepo web dashboard.

Available Tools

save_idea

Create a new idea in your repository.

Parameter	Type	Required	Description
title	string	Yes	Idea title (max 200 chars)
body	string	No	Full description in markdown
tags	string[]	No	Tags to apply
source_url	string	No	URL where the idea originated
status	string	No	captured, exploring, building, shipped, shelved
parent_id	number	No	Parent idea ID for sub-ideas

{
  "id": 42,
  "title": "Browser extension for idea capture",
  "status": "captured",
  "tags": ["chrome", "extension"],
  "processing": true,
  "created_at": "2026-03-24T10:30:00Z"
}

update_idea

Modify an existing idea.

Parameter	Type	Required	Description
id	number	Yes	Idea ID to update
title	string	No	New title
body	string	No	New body
status	string	No	New status
tags	string[]	No	Replace all tags
add_tags	string[]	No	Append tags without removing existing
remove_tags	string[]	No	Remove specific tags
link_to	object	No	{idea_id, relation_type, note} — link in the same call

delete_idea

Remove an idea permanently.

Parameter	Type	Required	Description
id	number	Yes	Idea ID to delete

search_ideas

Search your ideas by keyword or semantic meaning.

Parameter	Type	Required	Description
query	string	No	Search query (semantic + full-text)
status	string	No	Filter by status
tag	string	No	Filter by tag
limit	number	No	Results to return (default 20, max 100)
offset	number	No	Results to skip

{
  "ideas": [
    { "id": 42, "title": "Browser extension for idea capture", "status": "captured", "score": 0.92 },
    { "id": 17, "title": "Chrome plugin for code snippets", "status": "exploring", "score": 0.85 }
  ],
  "total": 2
}

get_idea

Retrieve a single idea with full details.

Parameter	Type	Required	Description
id	number	Yes	Idea ID
include_context	boolean	No	Include related ideas and links

list_tags

Returns all tags in your repository with idea counts. No parameters.

{
  "tags": [
    { "name": "chrome", "count": 3 },
    { "name": "mobile", "count": 7 }
  ]
}

link_ideas

Create a typed relation between two ideas.

Parameter	Type	Required	Description
source_idea_id	number	Yes	Source idea
target_idea_id	number	Yes	Target idea
relation_type	string	Yes	related, parent, blocks, inspires, duplicate, supersedes
note	string	No	Explanation of the relationship

unlink_ideas

Remove a relation between ideas.

Parameter	Type	Required	Description
relation_id	number	Yes	Relation ID to remove

Tips

Tip

Search before you save. Before asking Claude to save a new idea, ask it to search first. This avoids duplicates and often surfaces existing ideas you forgot about.

• Ask Claude to tag ideas as it saves them — “save this idea and tag it with mobile and mvp.”
• Use update_idea with add_tags to tag in bulk: “tag all my browser extension ideas with chrome.”
• Use include_context: true on get_idea to see the full network around an idea.

Troubleshooting

Issue	Solution
OAuth prompt keeps appearing	Revoke access in Settings > Connected Apps and re-authorize from scratch.
Connection timeout	Verify your network allows outbound HTTPS to neuralrepo.com. Corporate firewalls may block MCP transport.
”Not authorized” error	Your refresh token may have expired (90-day limit). Re-authorize via the OAuth flow.
Tool not appearing in Claude	Ensure the MCP server is correctly configured. In Claude Code, run claude mcp list to verify.
Rate limited	MCP requests count toward your daily API limit (100/day Free, 10,000/day Pro). Wait and retry.