Overseas Social MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PYTHONPATH | No | Path to the overseas-social-mcp checkout, required for the server module to be importable | |
| OSMCP_TG_API_ID | No | Telegram API ID obtained from my.telegram.org | |
| OSMCP_TG_SESSION | No | Telegram session string written by the telegram_login helper | |
| OSMCP_TG_API_HASH | No | Telegram API hash obtained from my.telegram.org | |
| OSMCP_CHROMEDRIVER | No | Path to ChromeDriver used by the LinkedIn backend | |
| OSMCP_X_ACCOUNTS_DB | No | Overrides the path to the twscrape X accounts database | |
| OSMCP_LINKEDIN_EMAIL | No | LinkedIn account email (throwaway account recommended) | |
| OSMCP_LINKEDIN_ENABLED | No | Set to true to enable the LinkedIn backend (high-risk, off by default) | false |
| OSMCP_REDDIT_CLIENT_ID | No | Reddit script app client ID | |
| OSMCP_LINKEDIN_PASSWORD | No | LinkedIn account password | |
| OSMCP_REDDIT_USER_AGENT | No | Reddit API user agent string | |
| OSMCP_REDDIT_CLIENT_SECRET | No | Reddit script app client secret |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| x_search | Search recent public tweets on X/Twitter matching a query. Args:
query: X search query (supports X search operators, e.g. Returns normalised items: {id, author, content, like_count, comment_count, publish_time, url, extra:{retweet_count, view_count, lang}}. Requires twscrape installed + X accounts added & logged in. |
| x_user_posts | Fetch recent public tweets from a specific X/Twitter user. Args: username: handle with or without leading @. max_count: max tweets (default from config, hard-capped). |
| reddit_search | Search Reddit posts (optionally within one subreddit) via the official API. Args: query: search query. subreddit: optional subreddit name (without r/); searches r/all if omitted. max_count: max posts (default from config, hard-capped). |
| reddit_subreddit_hot | Fetch hot posts from a subreddit via the official API. Args: subreddit: subreddit name (without r/). max_count: max posts (default from config, hard-capped). |
| reddit_post_comments | Fetch top-level comments of a Reddit post by its id. Args: post_id: Reddit submission id (the base36 id, not the full URL). max_count: max comments (default from config, hard-capped). |
| telegram_channel_messages | Fetch recent messages from a public Telegram channel or group (optionally filtered). Args: channel: channel/group username (with or without @), a t.me link (t.me/name, t.me/s/name, t.me/name/123), or a numeric -100… id. query: optional keyword to filter messages server-side. max_count: max messages (default from config, hard-capped). Items are newest first; publish_time is UTC. Requires telethon +
api_id/api_hash + an authorized session (one-time interactive login:
|
| linkedin_profile | Fetch a single LinkedIn profile (name, headline, experience, education). HIGH RISK: violates LinkedIn ToS and may restrict your account. Disabled by default; enable via OSMCP_LINKEDIN_ENABLED=true with a throwaway account. Args: profile_url: full https://www.linkedin.com/in/... URL. |
| linkedin_company | Fetch a single LinkedIn company page (industry, size, HQ, about). HIGH RISK: see linkedin_profile. Disabled by default. Args: company_url: full https://www.linkedin.com/company/... URL. |
| list_platforms | List supported platforms and their tools. |
| backend_status | Report which backends are configured & importable (without making calls). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |