Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chipsnews_mcp-1.0.1.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chipsnews_mcp-1.0.1-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

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

Hashes for chipsnews_mcp-1.0.1.tar.gz
Algorithm Hash digest
SHA256 30ed64288b9cb2e8072815901f144a0f435ead176e862dee0cca269a6738ad0a
MD5 7fa217ff1da58d8989724f1af73dda51
BLAKE2b-256 2e0ff64f3a7e5971c41c0320e65003dd6e786e1136e4b4bdfba053206ce70b32

See more details on using hashes here.

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

Hashes for chipsnews_mcp-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c0f08850724622626b12fdd1b1a32b35499d9c7ed06dbddf8effbc22aa0085e8
MD5 db9120ddfc11746985ddb4389be27318
BLAKE2b-256 12281d284aab4c90da066d36000cadb88cc5890ea50c1d437f31fb2bcd1068ab

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page