Skip to content

desearch-mcp-server 0.3.3

Latest

Choose a tag to compare

@Chkhikvadze Chkhikvadze released this 21 Oct 11:52
· 56 commits to main since this release
254b462

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-server

Hosted (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_criteria now reads each check's is_disqualifier and 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 include fully_verified, unverified_criteria, and enrichment / enrichment_error when the profile was not read. (#44)

0.3.1

  • x-search: min_retweets, min_replies and min_likes are typed as integers.
  • extract and web-crawl descriptions link to the API docs. (#43)

0.3.0

  • people-search accepts an optional metadata object of string labels (up to 10 keys), validated before the task starts.
  • people-search-tasks accepts an optional metadata filter (up to 3 pairs). Task summaries include metadata when 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-search is marked destructiveHint: 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 /api paths 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 search and fetch tools with output schemas.
  • Raw API keys, keyless tools/list and the 401 on keyless tools/call are 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_key is sent as Idempotency-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