<!-- mcp-name: io.github.fgasparetto/chipsnews-mcp -->

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