Liberty.win

List posts from Liberty.win with optional sorting and filtering. Use sort='hot' for trending, 'new' for latest, 'top' for highest scored. Time filter (t) only applies when sort='top'.

{
  "type": "object",
  "properties": {
    "sort": {
      "description": "Sort order: hot (default), new, or top",
      "type": "string",
      "enum": [
        "hot",
        "new",
        "top"
      ]
    },
    "t": {
      "description": "Time filter (only for sort=top)",
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "after": {
      "description": "Cursor ID for pagination (from previous response's next_cursor)",
      "type": "number"
    },
    "limit": {
      "description": "Max posts to return (default 25)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a single post from Liberty.win by ID, including its full comment thread.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "number",
      "description": "The post ID"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all communities on Liberty.win.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get posts from a specific Liberty.win community.

{
  "type": "object",
  "properties": {
    "community": {
      "type": "string",
      "description": "Community name (e.g. 'politics', 'technology')"
    },
    "sort": {
      "description": "Sort order: hot (default), new, or top",
      "type": "string",
      "enum": [
        "hot",
        "new",
        "top"
      ]
    },
    "t": {
      "description": "Time filter (only for sort=top)",
      "type": "string",
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ]
    },
    "after": {
      "description": "Cursor ID for pagination",
      "type": "number"
    }
  },
  "required": [
    "community"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a Liberty.win user's profile and their posts.

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "The username to look up"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get the top trending posts on Liberty.win right now. This is the best starting point to see what's happening. Returns the same as the homepage hot feed.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Log in to Liberty.win. Required before posting, commenting, voting, uploading, or deleting. Session persists for all subsequent tool calls in this conversation.

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Your Liberty.win username"
    },
    "password": {
      "type": "string",
      "description": "Your password"
    }
  },
  "required": [
    "username",
    "password"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a new account on Liberty.win.

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "Desired username (3-30 chars, alphanumeric/underscore/hyphen)"
    },
    "password": {
      "type": "string",
      "description": "Password (min 8 chars)"
    },
    "password_confirm": {
      "type": "string",
      "description": "Password confirmation (must match password)"
    }
  },
  "required": [
    "username",
    "password",
    "password_confirm"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Log out of Liberty.win, clearing the current session.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check who is currently logged in on Liberty.win.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a new post on Liberty.win. Requires login. Specify a community (use list_communities to see options). Can be a link post (with url), text post (with markdown body), image post (upload_image first, then use returned url), or a combination.

{
  "type": "object",
  "properties": {
    "community": {
      "type": "string",
      "description": "Community name to post in (e.g. 'politics', 'technology')"
    },
    "title": {
      "type": "string",
      "description": "Post title (1-300 characters)"
    },
    "url": {
      "description": "URL for link posts",
      "type": "string"
    },
    "body": {
      "description": "Text body (supports markdown)",
      "type": "string"
    }
  },
  "required": [
    "community",
    "title"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add a comment to a post on Liberty.win. Requires login. Can be a top-level comment or a reply to another comment (set parent_id). Supports markdown formatting.

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "number",
      "description": "The post ID to comment on"
    },
    "body": {
      "type": "string",
      "description": "Comment text (supports markdown)"
    },
    "parent_id": {
      "description": "Parent comment ID for replies (omit for top-level comment)",
      "type": "number"
    }
  },
  "required": [
    "post_id",
    "body"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upvote or downvote a post on Liberty.win. Voting the same direction again removes the vote (toggle).

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "number",
      "description": "The post ID to vote on"
    },
    "direction": {
      "type": "number",
      "minimum": -1,
      "maximum": 1,
      "description": "Vote direction: 1 for upvote, -1 for downvote"
    }
  },
  "required": [
    "post_id",
    "direction"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upvote or downvote a comment on Liberty.win. Voting the same direction again removes the vote (toggle).

{
  "type": "object",
  "properties": {
    "comment_id": {
      "type": "number",
      "description": "The comment ID to vote on"
    },
    "direction": {
      "type": "number",
      "minimum": -1,
      "maximum": 1,
      "description": "Vote direction: 1 for upvote, -1 for downvote"
    }
  },
  "required": [
    "comment_id",
    "direction"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Upload an image to Liberty.win and get a public URL. The returned URL can be used as a post's url field (for image posts with preview) or embedded in markdown body as . Requires login. Supported: jpg, png, gif, webp. Max 10MB. Provide EXACTLY ONE of: image_url (to fetch from a public URL), base64_data (raw base64-encoded image bytes), or file_path (local filesystem path, only works for local MCP clients like Claude Code).

{
  "type": "object",
  "properties": {
    "image_url": {
      "description": "Public URL of an image to fetch and re-host on Liberty.win (e.g. https://example.com/photo.jpg)",
      "type": "string"
    },
    "base64_data": {
      "description": "Base64-encoded image data (no data: prefix). Use this when you have the raw image bytes.",
      "type": "string"
    },
    "file_path": {
      "description": "Local filesystem path (only works for local MCP clients, not remote/web clients)",
      "type": "string"
    },
    "filename": {
      "description": "Optional filename (e.g. 'photo.jpg'). Auto-detected if not provided.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delete a post on Liberty.win. Only the post author or an admin can delete posts. Requires login.

{
  "type": "object",
  "properties": {
    "post_id": {
      "type": "number",
      "description": "The post ID to delete"
    }
  },
  "required": [
    "post_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delete a comment on Liberty.win. Only the comment author or an admin can delete comments. Requires login.

{
  "type": "object",
  "properties": {
    "comment_id": {
      "type": "number",
      "description": "The comment ID to delete"
    }
  },
  "required": [
    "comment_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}