Repository navigation
desearch-mcp-server 0.3.3
This release covers every change since 0.1.4. The server now has 22 tools, adds People Search (five tools), adds search and fetch, and supports OAuth 2.1 sign-in on the hosted endpoint.
Install
Local (stdio), with your Desearch API key in DESEARCH_API_KEY:
npx -y desearch-mcp-server
# or
npm install -g desearch-mcp-serverHosted (Streamable HTTP): https://mcp.desearch.ai/mcp
Authorization: Bearer <DESEARCH_API_KEY>(preferred)x-api-key: <DESEARCH_API_KEY>is also accepted- OAuth 2.1 sign-in is available for clients that follow the MCP authorization spec (discovery, dynamic client registration, PKCE S256, rotating refresh tokens)
Listing tools does not need a key. A tool call without a valid key or access token returns 401. Get a key at https://console.desearch.ai/api-keys.
Changes
0.3.3
- People Search:
unverified_criterianow reads each check'sis_disqualifierand falls back to the keyword rule. (#45)
0.3.2
- People Search task summaries include
completion_reason,coverage_limited(when true) and compact warnings. Person summaries includefully_verified,unverified_criteria, andenrichment/enrichment_errorwhen the profile was not read. (#44)
0.3.1
x-search:min_retweets,min_repliesandmin_likesare typed as integers.extractandweb-crawldescriptions link to the API docs. (#43)
0.3.0
people-searchaccepts an optionalmetadataobject of string labels (up to 10 keys), validated before the task starts.people-search-tasksaccepts an optionalmetadatafilter (up to 3 pairs). Task summaries includemetadatawhen it is not empty. (#41)- CI waits for npm to serve a new version before publishing to the MCP Registry, with retries. (#40)
0.2.4
people-searchis markeddestructiveHint: true. (#38)
0.2.3
- OAuth: the browser sign-in form on the authorize page now submits correctly. (#37)
0.2.2
- OAuth: discovery, register, authorize and token work on the hosted Node entrypoint (rewritten
/apipaths are mapped). (#36)
0.2.1
- Self-contained OAuth 2.1 for remote MCP clients: discovery, dynamic client registration, PKCE and rotating refresh tokens. Sign in with a Desearch API key; the access token is opaque and does not contain the key.
- OAuth sign-in hardening: rate limits on client registration and on sign-in attempts, and a same-origin check on the sign-in form submit.
- New
searchandfetchtools with output schemas. - Raw API keys, keyless
tools/listand the 401 on keylesstools/callare unchanged. (#33)
0.2.0
- Five People Search tools for X, YouTube, LinkedIn and TikTok:
people-search,people-search-status,people-search-control,people-search-tasks,people-profiles. Platform filters that do not apply to the chosen platform are rejected before the task starts.idempotency_keyis sent asIdempotency-Key. People tools reject unknown arguments. (#34)
Docs and metadata (no version change)
- README install lines, directory links and a web-search demo (#30), richer package description and keywords (#31), GitHub stars badge (#32).
Tools (22)
All tools are read-only except people-search and people-search-control.
| Tool | What it does |
|---|---|
ai-search |
AI search and analysis on the web |
x-search |
Search X posts, with optional filters |
web-search |
Web search with ranked titles, links and snippets |
web-links-search |
Web link search |
x-links-search |
Links from X posts that match a prompt |
x-posts-by-urls |
Fetch X posts by URL |
x-post-by-id |
Fetch one X post by ID |
x-posts-by-user |
X posts by a user, with an optional query |
x-post-retweeters |
Users who reposted an X post |
x-user-posts |
A user's X timeline |
x-user-replies |
Posts and replies by an X user |
x-post-replies |
Replies to an X post |
extract |
Page content as text or HTML (preferred over web-crawl) |
web-crawl |
Page content on the legacy crawl route |
x-trends |
Trending topics on X for a location (WOEID) |
search |
Public web search returning titles and links |
fetch |
Read a public page as text |
people-search |
Write. Starts a People Search task |
people-search-status |
Status, progress and people found for one task |
people-search-control |
Write. Pause, resume or cancel a People Search task |
people-search-tasks |
List your People Search tasks |
people-profiles |
Everyone your People Searches found on one platform |
Full diff: v0.1.4...v0.3.3