Sorsa MCP server

Sorsa MCP

An MCP server for the Sorsa.io API v3 — access to X/Twitter data: profiles, tweets, search, follow/retweet checks, Sorsa scores, lists and communities.

The server exposes 40 tools, one per API endpoint.

Installation

npm install
npm run build

Or, once published, run it with no install via npx (see below).

Configuration

You need a Sorsa API key. It is read from the SORSAAPIKEY environment variable and sent with every request in the ApiKey header.

Connecting a client

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project).

Using the published npm package (nothing to install, npx fetches it):

{
  "mcpServers": {
    "sorsa": {
      "command": "npx",
      "args": ["-y", "sorsa-mcp"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Or running from a locally built checkout:

{
  "mcpServers": {
    "sorsa": {
      "command": "node",
      "args": ["D:\\Code\\Cursor Projects\\Sorsa_MCP\\dist\\index.js"],
      "env": {
        "SORSA_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Claude Desktop

Edit %APPDATA%\Claude\claudedesktopconfig.json and add the same mcpServers block as above, then restart the app.

Local check

# build
npm run build

# run (communicates over stdio — easiest to test through a client)
SORSA_API_KEY=YOUR_KEY npm start

The quickest way to confirm your key works is the getkeyusage_info tool — it returns your remaining request balance and the key's expiration date.

Available tools

Profiles: getuserinfo, getuserinfobatch, getfollowers, getfollowing, getverifiedfollowers, getaccount_about

Tweets: gettweetinfo, gettweetinfobulk, getusertweets, gettweetcomments, gettweetquotes, getretweeters, getarticle, gettrends

Search: searchtweets, searchusers, searchmentions, getspace_info

Communities: getcommunitymembers, getcommunitytweets, searchcommunitytweets

Checks: checkfollow, checkcomment, checkquoted, checkretweet, checkcommunitymember

Sorsa metrics: getsorsascore, getsorsascorechanges, getfollowersstats, gettopfollowers, gettopfollowing, getnewfollowers7d, getnewfollowing_7d

Lists: getlistmembers, getlisttweets, getlistfollowers

Utilities: usernametoid, idtousername, linktoid, getkeyusage_info

Project layout

To add or change a tool, edit this file only.

• src/endpoints.ts — a declarative table of every endpoint (method, path, parameters).

• src/index.ts — the HTTP client plus tool registration driven by that table.

How it works

Each endpoint is one entry in ENDPOINTS. Based on each field's in (path / query / body), the handler routes arguments into the URL path, the query string, or the JSON body, then sends the request to Sorsa with the ApiKey header. The response is returned to the client as JSON text.

License

MIT