Add the hosted MCP URL to Claude or Cursor and authenticate in-browser.
Hosted MCP is the easiest path — no local server, no API key in your client config. You add a URL to Claude Desktop, Cursor, or any MCP-compatible client and authorize the connection through a browser consent flow. The OAuth token is scoped per-org and revocable from the dashboard.
# Claude Desktop and Cursor both support custom MCP servers via URL.# Add this URL in the client's MCP settings UI:## https://mcp.meetdewey.com/mcp## The first request opens a consent screen at app.meetdewey.com.# Approve, and the client receives a scoped OAuth token automatically.
Local MCP is useful if you want to avoid the hosted OAuth flow or run against a self-hosted Dewey. The server is published as `@meetdewey/mcp` on npm and runs over stdio. Drop the snippet into your client config file and your API key authorizes every call.
# Claude Desktop config locations:# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json# Windows: %APPDATA%\Claude\claude_desktop_config.json## Add the dewey entry to mcpServers:
The tools your agent gets when Dewey is connected.
Once Dewey is wired up, your MCP-compatible client gains a set of tools that map onto the REST API. Search and research are the most commonly invoked; the management tools come in handy when you want the agent to clean up its own corpus.
# Retrieval & research
dewey_list_collections # enumerate available collections
dewey_search # hybrid keyword + semantic chunk search
dewey_scan_sections # cheaper section-level scan
dewey_research # agentic research with configurable depth
dewey_get_section # full markdown of a single section
dewey_get_document_markdown # full markdown of a document# Document management
dewey_list_documents # statuses, tags, metadata
dewey_get_document_sections # table of contents
dewey_retry_document # retry a failed doc
dewey_delete_document
# Claims & contradictions
dewey_list_claims # filter by importance
dewey_list_contradictions
dewey_detect_contradictions
dewey_resolve_contradiction
# Duplicates
dewey_detect_duplicates
dewey_list_duplicate_groups
dewey_promote_duplicate_canonical
dewey_disband_duplicate_group
# Collection administration
dewey_get_collection_stats
dewey_update_collection
dewey_recompute_summaries
dewey_recompute_captions