MCP TabNews Integration

A Model Context Protocol (MCP) integration for TabNews.

This MCP server is also available on Smithery for direct integration.

Available Tools

checkStatusTool: Check the status of the TabNews API.
getContentsTool: Get contents from TabNews.
getContentsByUserTool: Get contents from TabNews by user.
getContentTool: Get a content with body from TabNews by user and slug.
getContentChildrenTool: Get comments from TabNews by content.
getAnalyticsUserCreatedTool: Get the analytics of a user created contents from TabNews.
getAnalyticsRootContentPublishedTool: Get the analytics of a root content published from TabNews.
getAnalyticsChildContentPublishedTool: Get the analytics of a child content published from TabNews.
getRssFeedTool: Get the RSS feed from TabNews.

Integration with AI Tools

Inspect MCP Server Capabilities

You can inspect this MCP server's capabilities using Smithery:

npx -y @smithery/cli@latest inspect @renant/mcp-tabnews

This will show you all available tools, their parameters, and how to use them.

Setup

Manual Installation

Make sure you're using Node.js v23+

node -v
#v23.11.0

Clone this repository:

git clone https://github.com/renant/mcp-tabnews.git
cd mcp-tabnews

Restore dependencies:

npm ci

Integration with AI Tools

Cursor Setup

Open Cursor Settings
Navigate to MCP section
Click "Add new MCP server"
Configure the server:
Name = mcp-tabnews Type = command Command = node ABSOLUTE_PATH_TO_PROJECT/src/index.ts
or if you prefer executing it from Smithery
Name = mcp-tabnews Type = command Command = npm exec -- @smithery/cli@latest run @renant/mcp-tabnews

or configure directly from the Cursor's global MCP file located in ~/.cursor/mcp.json and add the following:

{
  "mcpServers": {
    "mcp-tabnews": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

or if you prefer executing it from Smithery

{
  "mcpServers": {
    "mcp-tabnews": {
      "command": "npm",
      "args": [
        "exec",
        "--",
        "@smithery/cli@latest",
        "run",
        "@renant/mcp-tabnews"
      ]
    }
  }
}

Make sure Cursor chat is in Agent mode by selecting "Agent" in the lower left side dropdown
Go to the chat an ask any question about TabNews

Claude Desktop Setup

Installing via Smithery

To install TabNews for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @renant/mcp-tabnews --client claude

Development

Features

Built with Model Context Protocol (MCP)
Type-safe with TypeScript and Zod schema validation
Native TypeScript support in Node.js without transpilation
Standard I/O transport for easy integration
Structured error handling

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Renan Teixeira

License

This project is licensed under the MIT License - see the LICENSE file for details.