Skip to main content
Glama
Hyperlink MCP

Hyperlink MCP

Hyperlink MCP

One MCP server, many platforms. Hyperlink MCP gives an LLM agent a single connection through which it can read, post, comment, and engage on forums, comment sections, and social media as the user β€” for marketing, SEO research, and community engagement.

Instead of wiring one MCP server per platform into every client, you connect Hyperlink once and add platforms as adapters.

Status

Platform

Adapter

Auth

Capabilities

Substack

βœ… opt-in (SUBSTACK_ENABLE)

session cookie

full substack-mcp surface (drafts, Notes, feed, comments, restack, tags, settings, stats)

Reddit

βœ… opt-in (REDDIT_ENABLE)

OAuth

whoami, feed, search, thread, submit, comment, vote

Hacker News

βœ… always on

none (public API)

feed, thread, search, user profile (read-only)

X (Twitter)

πŸ”œ planned

session cookie

read + post + reply

Threads

πŸ”œ planned

session cookie

read + post + reply

LinkedIn

πŸ”œ planned

session cookie

read + post + reply

LIHKG

πŸ”œ planned

session cookie

read + post + reply

Discourse forums

πŸ”œ planned

API key

read + post + reply

Medium

πŸ”œ planned

session cookie

read + comment + clap

Quora

πŸ”œ planned

session cookie

read + answer + comment

Dev.to

πŸ”œ planned

API key

read + post + comment

Product Hunt

πŸ”œ planned

OAuth

read + comment + upvote

YouTube comments

πŸ”œ planned

OAuth

read + comment

(See src/platforms/_template/ to add one.)

Related MCP server: @isteam/linkedin-mcp

Quick start

nvm use
npm install                 # also runs tsc via prepare
npx playwright install chromium   # needed for Substack Notes
npm run smoke               # build + list platforms/tools + live HN

Register with an MCP client (e.g. Claude Code):

claude mcp add hyperlink -- node /path/to/hyperlink-mcp/dist/src/index.js

Or in a JSON MCP config (enable platforms via env):

{
  "mcpServers": {
    "hyperlink": {
      "command": "node",
      "args": ["/path/to/hyperlink-mcp/dist/src/index.js"],
      "env": {
        "REDDIT_ENABLE": "true",
        "REDDIT_CLIENT_ID": "...",
        "REDDIT_CLIENT_SECRET": "...",
        "REDDIT_REFRESH_TOKEN": "...",
        "SUBSTACK_ENABLE": "true",
        "SUBSTACK_PUBLICATION_URL": "https://yourname.substack.com",
        "SUBSTACK_SESSION_TOKEN": "...",
        "SUBSTACK_USER_ID": "..."
      }
    }
  }
}

Platform setup

A platform is enabled only when its *_ENABLE flag is truthy (true / 1 / yes) and every required parameter below is set. list_platforms shows what is missing.

Substack

Session-cookie auth. Log in to Substack in your browser, then copy the substack.sid cookie value and your numeric user id.

Parameter

Required

Description

SUBSTACK_ENABLE

βœ…

Set to true to enable the adapter

SUBSTACK_PUBLICATION_URL

βœ…

Your publication URL, e.g. https://yourname.substack.com

SUBSTACK_SESSION_TOKEN

βœ…

substack.sid session cookie value

SUBSTACK_USER_ID

βœ…

Numeric Substack user id

SUBSTACK_USE_CHROME

optional

Set to 1 to prefer installed Chrome over bundled Chromium for Notes

Notes create/reply drive a real browser (Cloudflare-protected endpoints) β€” install Playwright Chromium once:

npx playwright install chromium

Reddit

OAuth with a permanent refresh token. Create an app at https://www.reddit.com/prefs/apps (type script or web app), then run the OAuth code flow once with duration=permanent to obtain a refresh token.

Parameter

Required

Description

REDDIT_ENABLE

βœ…

Set to true to enable the adapter

REDDIT_CLIENT_ID

βœ…

App client id from reddit.com/prefs/apps

REDDIT_CLIENT_SECRET

βœ…

App client secret

REDDIT_REFRESH_TOKEN

βœ…

Permanent OAuth refresh token

REDDIT_USER_AGENT

optional

Custom user agent, e.g. hyperlink-mcp/0.1.0 (by /u/yourusername)

Hacker News

No setup β€” public Firebase/Algolia APIs, read-only, always on.

Parameter

Required

Description

β€”

β€”

No configuration needed

How it works

src/
  index.ts              MCP server bootstrap (stdio transport)
  core/registry.ts      collects adapters, namespaces tools, gates on enableEnv + requiredEnv
  platforms/
    index.ts            the adapter list β€” register new platforms here
    _template/          copy me: documented adapter skeleton
    hackernews/         reference adapter (public API, no auth)
    reddit/             OAuth adapter (adapter.ts + api.ts)
    substack/           full port of substack-mcp (adapter.ts + api/ + tools/ + utils/)
dist/                   tsc output β€” MCP clients point here
  • Every adapter exposes tools namespaced by platform: hackernews_search, reddit_comment, …

  • Optional enableEnv (e.g. REDDIT_ENABLE) must be truthy (true / 1 / yes); then every requiredEnv credential must be set. Until then the platform is disabled but visible β€” list_platforms lists what is missing.

  • Adapters aim for a shared verb set (whoami, get_feed, search, get_thread, create_post, comment, react) plus platform-specific extras, so agent skills transfer between platforms.

Adding a platform

  1. Copy src/platforms/_template/ to src/platforms/<platform>/.

  2. Fill in id, name, optional enableEnv, requiredEnv, and implement the tool handlers (adapter.ts + api.ts as needed).

  3. Register the adapter in src/platforms/index.ts.

  4. npm run build then npm run smoke / npm run test:registry.

Auth guidance lives in the template. For cookie-auth platforms behind bot detection (Cloudflare etc.), the proven pattern is playwright-extra + stealth with in-page fetch() calls β€” see src/platforms/substack/tools/create_note.ts and utils/notesBrowser.ts.

Configuration

All credentials come from environment variables, one prefix per platform (see .env.example). No credentials are ever written to disk by this server.

A note on responsible use

This server acts as the authenticated user, on their own accounts, at their direction. Use it for genuine engagement and research. Platform terms of service still apply β€” spam and inauthentic behaviour will get accounts banned regardless of tooling.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Campaign-driven social engagement MCP server for authentic developer community interaction (Dev.to, Bluesky, Twitter, Reddit) with a streamlined scout-draft-strike pipeline minimizing LLM round trips.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.
      42
      MIT