Hacker News API and MCP server Let your AI agent read what you saved on Hacker News.

ToolWhat it doesAccess

• list_upvoted_items List what you upvoted: stories by default, comments with comments set to true. read

  Returns the items of your upvoted page in the order Hacker News shows them, one page per call, with a next_page number while more pages exist. Only you can see this list, so it needs your session.

  MCP callhacker_news_read → list_upvoted_items

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/upvoted-items

  Parameters

  Parameters: list_upvoted_items

  Name	Type	Description
  comments boolean	boolean	true lists upvoted comments instead of stories. Default false
  page integer	integer	Page of the list, starting at 1. Default 1

  Example response

  {
    "items": [
      {
        "id": 45012345,
        "title": "Show HN: A tiny SQLite sync engine",
        "site": "example.dev",
        "points": 412,
        "comments": 96,
        "by": "quillmark",
        "age": "2 days ago"
      },
      {
        "id": 45009876,
        "title": "Why we left our message queue",
        "site": "example.org",
        "points": 188,
        "comments": 54,
        "by": "denny_ro",
        "age": "3 days ago"
      },
      {
        "id": 45003210,
        "title": "Notes on running Postgres at small scale",
        "site": "example.net",
        "points": 97,
        "comments": 31,
        "by": "lukasz_k",
        "age": "5 days ago"
      }
    ],
    "next_page": 2
  }

• list_hidden_items List the stories you hid from your own view. read

  Returns your hidden page in Hacker News order, one page per call. Hiding removes a submission from your personal view only; others still see it. The list is private to you.

  MCP callhacker_news_read → list_hidden_items

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/hidden-items

  Parameters

  Parameters: list_hidden_items

  Name	Type	Description
  page integer	integer	Page of the list, starting at 1. Default 1

  Example response

  {
    "items": [
      {
        "id": 45001111,
        "title": "Ten rules for better standups",
        "site": "example.com",
        "points": 63,
        "comments": 12,
        "by": "ana_pl",
        "age": "6 days ago"
      }
    ],
    "next_page": null
  }

• list_favorites List the stories or comments you added to your favorites. read

  Returns your favorites in the order Hacker News shows them, one page per call. Favorites are the list you build with the favorite link on an item page. The list is public on Hacker News, and this tool reads it through your session.

  MCP callhacker_news_read → list_favorites

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/favorites

  Parameters

  Parameters: list_favorites

  Name	Type	Description
  comments boolean	boolean	true lists favorite comments instead of stories. Default false
  page integer	integer	Page of the list, starting at 1. Default 1

  Example response

  {
    "items": [
      {
        "id": 44998877,
        "title": "The cost of a cold start",
        "site": "example.dev",
        "points": 240,
        "comments": 73,
        "by": "ivo_b",
        "age": "1 week ago"
      }
    ],
    "next_page": null
  }

ToolWhat it doesAccess

• get_my_profile Read the signed-in account: username, karma, age and the about text. read

  Returns the account behind the Cloud Browser session. It is the call to make first to check that the session is signed in and which username the other tools act for.

  MCP callhacker_news_read → get_my_profile

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/my-profile

  Parameters

  No parameters.

  Example response

  {
    "username": "maya_dev",
    "karma": 1284,
    "created": "2019-03-14",
    "about": "Building small tools."
  }

• list_my_comments List your comments with the thread each one belongs to. read

  Returns your comments newest first, each with the story it sits under and a reply_count. Use get_item on a comment id to read the replies.

  MCP callhacker_news_read → list_my_comments

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/my-comments

  Parameters

  Parameters: list_my_comments

  Name	Type	Description
  page integer	integer	Page of the list, starting at 1. Default 1

  Example response

  {
    "items": [
      {
        "id": 45013001,
        "story_id": 45012345,
        "story_title": "Show HN: A tiny SQLite sync engine",
        "text": "We tried the same approach and hit clock skew first.",
        "reply_count": 2,
        "age": "5 hours ago"
      }
    ],
    "next_page": null
  }

• list_my_submissions List the stories you submitted, with points and comment counts. read

  Returns your submitted page newest first, one page per call. Each row has the points and the comment count at the time of the call, so run it again later to see how a post moved.

  MCP callhacker_news_read → list_my_submissions

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/my-submissions

  Parameters

  Parameters: list_my_submissions

  Name	Type	Description
  page integer	integer	Page of the list, starting at 1. Default 1

  Example response

  {
    "items": [
      {
        "id": 44990001,
        "title": "Show HN: A tiny SQLite sync engine",
        "site": "example.dev",
        "points": 412,
        "comments": 96,
        "by": "maya_dev",
        "age": "2 weeks ago"
      }
    ],
    "next_page": null
  }

• get_item Read one story, comment or poll with its comment tree. read

  Returns the item and its replies in the ranked order Hacker News shows. Signed in, it also tells you whether the item is in your favorites.

  MCP callhacker_news_read → get_item

  REST endpointGET https://cotlet.dev/api/v1/hacker-news/item

  Parameters

  Parameters: get_item

  Name	Type	Description
  id integer required	integer	Item id, the number after id= in the item URL
  depth integer	integer	How many levels of replies to return. Default 2

  Example input

  {
    "id": 1
  }

  Example response

  {
    "id": 45012345,
    "type": "story",
    "title": "Show HN: A tiny SQLite sync engine",
    "by": "quillmark",
    "points": 412,
    "comment_count": 96,
    "favorited": false,
    "comments": [
      {
        "id": 45012900,
        "by": "denny_ro",
        "text": "How does it handle clock skew between devices?",
        "replies": [
          {
            "id": 45013001,
            "by": "maya_dev",
            "text": "We tried the same approach and hit clock skew first.",
            "replies": []
          }
        ]
      }
    ]
  }

ToolWhat it doesAccess

• favorite_item Add a story or comment to your favorites, or remove it with favorite set to false. write

  Changes only your own favorites list. It reaches nobody and one call undoes it, so it does not wait for your OK. It does not vote on the item.

  MCP callhacker_news_write → favorite_item

  REST endpointPOST https://cotlet.dev/api/v1/hacker-news/item/favorite

  Parameters

  Parameters: favorite_item

  Name	Type	Description
  id integer required	integer	Item id
  favorite boolean	boolean	false removes it from your favorites. Default true

  Example input

  {
    "id": 45012345,
    "favorite": true
  }

  Example response

  {
    "id": 45012345,
    "favorited": true
  }

• hide_item Hide a story from your own view, or show it again with hide set to false. write

  Hacker News removes a hidden submission from your personal view only; others still see it. It reaches nobody and one call undoes it, so it does not wait for your OK.

  MCP callhacker_news_write → hide_item

  REST endpointPOST https://cotlet.dev/api/v1/hacker-news/item/hide

  Parameters

  Parameters: hide_item

  Name	Type	Description
  id integer required	integer	Story id
  hide boolean	boolean	false shows the story again. Default true

  Example input

  {
    "id": 1
  }

  Example response

  {
    "id": 45001111,
    "hidden": true
  }