Modusop Mcp
Thin stdio-to-HTTP proxy that connects MCP clients to Modus Brain's knowledge base API at brain.modusop.app. All tool logic lives server-side, so you automatically get new capabilities without reinstalling. Ships with semantic search, chunk retrieval, client briefs, observation logging, and decision tracking. The proxy itself is stateless: it forwards JSON-RPC over stdio to Brain's HTTP endpoint and pipes responses back. If your client speaks remote MCP natively, skip this and hit the Brain URL directly. Otherwise, drop your Brain token into the env config, point your client at npx, and restart. Replaces the older 0.x tools that talked directly to ModusOp's API with a unified knowledge-first interface.
- tools
- 9
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 27, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
whoamiidentify the user + org this token is scoped to
identify the user + org this token is scoped to
No parameter schema in public metadata yet.
search_knowledgesemantic search over the org KB
semantic search over the org KB
No parameter schema in public metadata yet.
get_chunkdeep-dive on a specific search result
deep-dive on a specific search result
No parameter schema in public metadata yet.
list_recentrecently indexed KB items
recently indexed KB items
No parameter schema in public metadata yet.
get_client_briefsynthesised client one-pager
synthesised client one-pager
No parameter schema in public metadata yet.
add_observationappend a note
append a note
No parameter schema in public metadata yet.
add_decisionrecord context + decision + rationale
record context + decision + rationale
No parameter schema in public metadata yet.
link_observationtyped link between two chunks
typed link between two chunks
No parameter schema in public metadata yet.
request_deleteadmin-gated removal
admin-gated removal
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MODUSOP_API_TOKEN*secretModusOp API token. Create at modusop.app → Settings → API Tokens (read + write scopes).
MODUSOP_API_URLOverride the API base URL. Defaults to https://modusop.app/api/v1.
Readme
@modusop/mcp-server
Stdio→HTTP proxy for Modus Brain — gives any MCP-aware AI client (Claude Desktop, Cursor, Cline, Continue.dev, etc.) access to your ModusOp organisation's knowledge base.
What it does
This package is a thin proxy. It speaks the MCP stdio transport on one end and forwards every JSON-RPC request to Modus Brain's HTTP MCP endpoint on the other.
All tool implementations live in Modus Brain itself — when ModusOp ships a new Brain tool, every install of this package picks it up automatically on the next request. No re-publish, no version bump, no user action needed.
If your AI client speaks remote HTTP MCP natively, you don't need this package at all — point it directly at https://brain.modusop.app/mcp. This package exists for clients that only speak stdio.
Setup
1. Get a Brain token
Sign in at brain.modusop.app, generate a token labelled for the device or person who'll use it, copy the plaintext value (you only see it once).
2. Add to your AI client's MCP config
Details
- Repository
- github.com/jwwd-repos/modusop-mcp
- Package
@modusop/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active