truth-social-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TRUTH_SOCIAL_MCP_BASE_URL | No | API origin; mainly for authorized/test deployments | https://truthsocial.com |
| TRUTH_SOCIAL_MCP_AUTHORIZED | No | Permit live API calls after external authorization | 0 |
| TRUTH_SOCIAL_MCP_TIMEOUT_MS | No | Request timeout | 30000 |
| TRUTH_SOCIAL_MCP_USER_AGENT | No | Honest client identification | truthsocial-mcp/<version> ... |
| TRUTH_SOCIAL_MCP_ALLOW_WRITES | No | Register mutation tools at startup | 0 |
| TRUTH_SOCIAL_MCP_UPLOAD_ROOTS | No | Colon-separated media roots | ~/.truth_social_mcp/uploads |
| TRUTH_SOCIAL_MCP_MAX_UPLOAD_MB | No | Maximum local media size | 25 |
| TRUTH_SOCIAL_MCP_ALLOW_CUSTOM_ORIGIN | No | Permit a non-Truth-Social HTTPS test/authorized origin | 0 |
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 |
|---|---|
| truth_auth_statusA | Show local token/configuration state without contacting Truth Social. |
| truth_logoutA | Delete the locally stored Truth Social token from Keychain. Requires explicit confirmation. |
| truth_instance_infoA | Fetch public Truth Social instance capabilities and limits. |
| truth_verifyA | Verify the configured bearer token and return its account. |
| truth_lookup_userA | Resolve a public Truth Social username to a compact account record. |
| truth_get_userB | Fetch a Truth Social account by numeric ID. An authorized token is required. |
| truth_get_user_postsB | Fetch recent public posts for a username. Pagination IDs must be numeric. |
| truth_followersA | List followers for an account. An authorized token is required. |
| truth_followingA | List accounts followed by a user. An authorized token is required. |
| truth_home_timelineA | Fetch the authorized account's home timeline. |
| truth_trendingA | Fetch trending statuses. Truth Social currently requires an authorized token. |
| truth_get_statusA | Fetch one public Truth Social post by numeric ID. |
| truth_get_threadA | Fetch a post and its ancestors/descendants. An authorized token is required for context. |
| truth_searchA | Search statuses, accounts or hashtags. Truth Social requires an authorized token. |
| truth_notificationsB | Fetch notifications for the authorized account. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool targets a distinct resource and action: posts (get_status, get_thread), search, users (lookup_user, get_user, get_user_posts), relationships (followers, following), timelines (home_timeline, trending), notifications, and auth (auth_status, logout, verify). Even get_status and get_thread are clearly differentiated by thread context.
All tools share the truth_ prefix, but the pattern after the prefix is inconsistent: some are verb_noun (get_status, lookup_user), some are single verbs (search, logout), and some are bare nouns (followers, trending). This mixed style makes the set less predictable.
15 tools is within the well-scoped range for a social media API server, covering posts, users, relationships, timelines, notifications, and auth. Each tool serves a clear purpose without feeling bloated.
The tool set is heavily read-oriented and lacks any write operations such as posting, liking, replying, or following. While it covers the main read paths, the absence of social interactions makes it an incomplete client for the stated domain.