{
  "markdown": "<!-- mcp-name: io.github.fgasparetto/chipsnews-mcp -->\n\n# ChipsNews MCP Server\n\nMCP (Model Context Protocol) server for [ChipsNews](https://news.chipsbuilder.com) — manage news configuration, sources, articles, and fetch triggers from Claude Code, Claude Desktop, or any MCP client.\n\n## Requirements\n\n- Python 3.11+\n- [uv](https://docs.astral.sh/uv/) (recommended) or pip\n- A ChipsNews API key\n\n## Quick Start\n\nNo installation needed with `uv`:\n\n```bash\nuv run --script server.py\n```\n\nOr install manually:\n\n```bash\npip install \"mcp[cli]\" httpx\npython server.py\n```\n\n## Configuration\n\nThe server uses environment variables for authentication:\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `CHIPSNEWS_API_URL` | API base URL | `https://news.chipsbuilder.com` |\n| `CHIPSNEWS_API_KEY` | Your API key (Bearer token) | — |\n\n### Claude Code\n\nAdd to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chipsnews\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--script\", \"/path/to/chipsnews-mcp/server.py\"],\n      \"env\": {\n        \"CHIPSNEWS_API_URL\": \"https://news.chipsbuilder.com\",\n        \"CHIPSNEWS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chipsnews\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--script\", \"/path/to/chipsnews-mcp/server.py\"],\n      \"env\": {\n        \"CHIPSNEWS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Configuration\n\n| Tool | Description |\n|------|-------------|\n| `get_config` | Get news configuration (keywords, language, frequency, etc.) |\n| `update_config` | Update configuration fields (keywords, language, frequency, auto_publish, notification_email, pin_duration_hours, etc.) |\n\n### Sources\n\n| Tool | Description |\n|------|-------------|\n| `list_sources` | List all news sources |\n| `create_source` | Create a new source (rss, google, reddit) |\n| `update_source` | Update an existing source |\n| `delete_source` | Delete a source |\n\n### Articles\n\n| Tool | Description |\n|------|-------------|\n| `list_articles` | List articles with optional filters (status, keyword, source, page) |\n| `get_article` | Get full details of a single article |\n| `approve_article` | Approve and publish an article |\n| `reject_article` | Reject an article |\n| `pin_article` | Pin an article to the top (TOP) |\n| `unpin_article` | Remove pin from an article |\n| `lock_article` | Lock an article to protect from rotation cleanup |\n| `unlock_article` | Unlock an article |\n| `delete_article` | Delete an article |\n| `delete_all_articles` | Delete ALL articles (use with caution) |\n\n### Fetch & Stats\n\n| Tool | Description |\n|------|-------------|\n| `trigger_fetch` | Trigger a manual news fetch from all active sources |\n| `get_stats` | Get usage statistics: article counts, API calls, fetch history |\n\n## Usage Examples\n\nOnce configured, use natural language in Claude:\n\n- *\"List all news sources\"*\n- *\"Add an RSS feed for TechCrunch\"*\n- *\"Show published articles\"*\n- *\"Approve article 42\"*\n- *\"Pin the top article\"*\n- *\"Trigger a news fetch\"*\n- *\"Show news stats\"*\n- *\"Update keywords to AI, startup, fintech\"*\n\n## Authentication\n\nThe server uses API key authentication (Bearer token). Pass your key via the `CHIPSNEWS_API_KEY` environment variable.\n\n## License\n\nMIT\n",
  "bytes": 3344,
  "sha": "b92ecdd852e560c3275f54d9e187b05766c3e1fdb6178fe8c6f2306e4b652fc0",
  "repo_slug": "fgasparetto/chipsnews-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_fgasparetto_chipsnews_mcp_1a52aa8e/readme"
}