ChipsNews MCP Server

MCP (Model Context Protocol) server for ChipsNews — manage news configuration, sources, articles, and fetch triggers from Claude Code, Claude Desktop, or any MCP client.

Requirements

Python 3.11+
uv (recommended) or pip
A ChipsNews API key

Quick Start

No installation needed with uv:

uv run --script server.py

Or install manually:

pip install "mcp[cli]" httpx
python server.py

Configuration

The server uses environment variables for authentication:

| Variable | Description | Default | |----------|-------------|---------| | CHIPSNEWS_API_URL | API base URL | https://news.chipsbuilder.com | | CHIPSNEWS_API_KEY | Your API key (Bearer token) | — |

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "chipsnews": {
      "command": "uv",
      "args": ["run", "--script", "/path/to/chipsnews-mcp/server.py"],
      "env": {
        "CHIPSNEWS_API_URL": "https://news.chipsbuilder.com",
        "CHIPSNEWS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "chipsnews": {
      "command": "uv",
      "args": ["run", "--script", "/path/to/chipsnews-mcp/server.py"],
      "env": {
        "CHIPSNEWS_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Configuration

| Tool | Description | |------|-------------| | get_config | Get news configuration (keywords, language, frequency, etc.) | | update_config | Update configuration fields (keywords, language, frequency, auto_publish, notification_email, pin_duration_hours, etc.) |

Sources

| Tool | Description | |------|-------------| | list_sources | List all news sources | | create_source | Create a new source (rss, google, reddit) | | update_source | Update an existing source | | delete_source | Delete a source |

Articles

| Tool | Description | |------|-------------| | list_articles | List articles with optional filters (status, keyword, source, page) | | get_article | Get full details of a single article | | approve_article | Approve and publish an article | | reject_article | Reject an article | | pin_article | Pin an article to the top (TOP) | | unpin_article | Remove pin from an article | | lock_article | Lock an article to protect from rotation cleanup | | unlock_article | Unlock an article | | delete_article | Delete an article | | delete_all_articles | Delete ALL articles (use with caution) |

Fetch & Stats

| Tool | Description | |------|-------------| | trigger_fetch | Trigger a manual news fetch from all active sources | | get_stats | Get usage statistics: article counts, API calls, fetch history |

Usage Examples

Once configured, use natural language in Claude:

"List all news sources"
"Add an RSS feed for TechCrunch"
"Show published articles"
"Approve article 42"
"Pin the top article"
"Trigger a news fetch"
"Show news stats"
"Update keywords to AI, startup, fintech"

Authentication

The server uses API key authentication (Bearer token). Pass your key via the CHIPSNEWS_API_KEY environment variable.

License

MIT

ChipsNews MCP Server