MCP server for ChipsNews — manage news sources, articles, and fetch triggers from any MCP client
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file chipsnews_mcp-1.0.1.tar.gz.
File metadata
- Download URL: chipsnews_mcp-1.0.1.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.10","id":"questing","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30ed64288b9cb2e8072815901f144a0f435ead176e862dee0cca269a6738ad0a
|
|
| MD5 |
7fa217ff1da58d8989724f1af73dda51
|
|
| BLAKE2b-256 |
2e0ff64f3a7e5971c41c0320e65003dd6e786e1136e4b4bdfba053206ce70b32
|
File details
Details for the file chipsnews_mcp-1.0.1-py3-none-any.whl.
File metadata
- Download URL: chipsnews_mcp-1.0.1-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"25.10","id":"questing","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c0f08850724622626b12fdd1b1a32b35499d9c7ed06dbddf8effbc22aa0085e8
|
|
| MD5 |
db9120ddfc11746985ddb4389be27318
|
|
| BLAKE2b-256 |
12281d284aab4c90da066d36000cadb88cc5890ea50c1d437f31fb2bcd1068ab
|