{"$schema":"https://modelcontextprotocol.io/schemas/server-card/v1.json","name":"hackernews-agent-mcp","title":"Hacker News Agentic Protocol Server","description":"Stateless MCP Server exposing tools to browse top stories, read threaded discussions, search archives, upvote, and submit posts on Hacker News.","version":"1.0.0","transport":{"type":"streamable-http","url":"https://hackernews-agentic.pages.dev/mcp"},"capabilities":{"tools":true,"resources":true,"prompts":false,"logging":false},"tools":[{"name":"get_top_stories","description":"Fetch top ranked stories on Hacker News using the gravity score algorithm.","inputSchema":{"type":"object","properties":{"page":{"type":"number","default":1,"description":"Page number (default: 1)"},"limit":{"type":"number","default":30,"description":"Number of stories to return (default: 30, max: 50)"}}}},{"name":"get_newest_stories","description":"Fetch newest stories chronologically.","inputSchema":{"type":"object","properties":{"page":{"type":"number","default":1},"limit":{"type":"number","default":30}}}},{"name":"get_story","description":"Fetch a specific story by ID including its nested comment tree.","inputSchema":{"type":"object","properties":{"id":{"type":"number","description":"Item ID of the story"}},"required":["id"]}},{"name":"search_stories","description":"Search stories by keyword across titles, URLs, and submission text.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search term or query"},"limit":{"type":"number","default":20}},"required":["query"]}},{"name":"submit_story","description":"Submit a new story or discussion thread to Hacker News.","inputSchema":{"type":"object","properties":{"title":{"type":"string","description":"Story title"},"url":{"type":"string","description":"URL for link submission"},"text":{"type":"string","description":"Body text for Ask HN or text submission"}},"required":["title"]}},{"name":"add_comment","description":"Post a reply comment to a story or existing comment.","inputSchema":{"type":"object","properties":{"parentId":{"type":"number","description":"ID of parent story or comment"},"text":{"type":"string","description":"Markdown or plain text comment body"}},"required":["parentId","text"]}},{"name":"upvote_story","description":"Cast an upvote for a story or comment.","inputSchema":{"type":"object","properties":{"itemId":{"type":"number","description":"ID of the item to upvote"}},"required":["itemId"]}},{"name":"get_user_profile","description":"Inspect user karma, bio, and recent submissions.","inputSchema":{"type":"object","properties":{"username":{"type":"string","description":"Username to inspect"}},"required":["username"]}}]}