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.0.tar.gz (5.5 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.0-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file chipsnews_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: chipsnews_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 5.5 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.0.tar.gz
Algorithm Hash digest
SHA256 3431849544a575e1cca8d6697086ec26682240573508fdba398f3397ff3874cd
MD5 ad15e34b314c496cd80f8276d8d73b49
BLAKE2b-256 e072b19d9e605d485ac88fe1226160d16d101e433ebf1058ae6928ad0bb99166

See more details on using hashes here.

File details

Details for the file chipsnews_mcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: chipsnews_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 11.5 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9dc444e7b2f4f329b97c5dec078334d853906ffdcda93556bfe888035d83eac5
MD5 333ba9d4e7c5fa785c74c984eb24bfb1
BLAKE2b-256 a6e4c616ae1e675494bedb7e86daa393be3d0129cd8f97f063134b63faae7aac

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