How to add ReactUse MCP to Windsurf

AI-powered discovery and documentation for the @reactuses/core React Hooks library. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 1.0k★ · stdio · no auth

Windsurf config for ReactUse MCP

npx -y @reactuses/mcp@latest

{
  "mcpServers": {
    "reactuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@reactuses/mcp@latest"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the ReactUse MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5ReactUse MCP's tools become available to Cascade.

Before you start

Node.js (npx available)
An MCP-compatible client (e.g. Claude, Cursor, Windsurf)

What ReactUse MCP can do in Windsurf

get_hook

Fetch full documentation (description, usage example, API table) for a specific @reactuses/core React hook by name. Hook name is case-insensitive, e.g. 'useToggle', 'useClipboard'.

list_hooks

List all available @reactuses/core hooks, optionally filtered by category (one of: browser, effect, element, state, integrations).

search_hooks

Search @reactuses/core hooks by name, description, or content; results ranked by relevance, with an optional result limit (default 20, max 50).

ReactUse MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the ReactUse MCP config there under the "mcpServers" key and restart the client.

Does this server require an API key or authentication?

No. It runs locally over stdio via npx and exposes read-only documentation tools, so no API key or auth is needed.

What does the server expose?

Three read-only tools — get_hook, list_hooks, and search_hooks — plus MCP resources and prompts for the ReactUse hooks library documentation.

How do I install it?

Add the @reactuses/mcp entry to your MCP client configuration with command 'npx' and args ['-y', '@reactuses/mcp@latest'], using the stdio transport, as shown in the project README.

View repo Full ReactUse MCP page