free-crypto-news

Name: free-crypto-news
Author: nirholas

finance MCP Server

Free crypto news API - real-time aggregator for Bitcoin, Ethereum, DeFi, Solana & altcoins. No API key required. RSS/Atom feeds, JSON REST API, historical archive with market context, embeddable widgets, ChatGPT plugin, Claude MCP server, SDKs (Python, TypeScript, Go, React, PHP). AI/LLM ready. Vibe coding friendly. Open source.

bynirholas

VerifiedInstall Ready

financefinance typescript python

5 views308 stars44 forksv1.0.10NOASSERTION

View on GitHub Homepage Docs

Why This Matters

Discovered via github-topic:mcp and last synced 1w ago.

VerifiedInstall Ready

Source: github-topic:mcp
Stars: 308
Last synced: 1w ago
Install: Instructions detected

Install

1. Install the package

npx -y @nirholas/free-crypto-news-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "free-crypto-news": {
      "command": "npx",
      "args": [
        "-y",
        "@nirholas/free-crypto-news-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

168

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (168)

Required

No

main

Stable production branch — Original API-focused design

Shortcut

Action

CryptoPanic

Others

5

Cointelegraph Español, Diario Bitcoin, CriptoNoticias, BeInCrypto Español, Bitcoiner Today

Network-first

5 minutes

Tier

Daily Limit

get_api_health

API health check

ARCHIVE_DIR

`./archive`

web-vitals

Core Web Vitals monitoring

Kotlin

[`crypto-news-kt`](sdk/kotlin/)

Limited

None

0

1-2

Content

Strategy

1

Varies

Metric

Value

Images

Cache-first

Enter

Open selected article

Balanced

`askUltimate()`

Carousel

JavaScript

Branch

Description

Navigation

Network-first + offline fallback

Mode

Function

iframe

Full news feed embed

historical-trend-analysis

Analyze historical news trends

topic

`/api/analyze`

asset

`/api/sentiment`

9

Block Media, TokenPost, CoinDesk Korea, Decenter, Cobak, The B.Chain, Upbit Blog, Blockchain Today Korea, CryptoQuant Blog

3

Cointelegraph Indonesia, Blockchain Media, Pintu Academy

Escape

Close modal

Exports

`e2e/exports.spec.ts`

WebSocket

Live prices, liquidations

2

Cointelegraph Arabic, ArabiCrypto

Cache-first

7 days

Page

Description

coin-research

Deep-dive research on any cryptocurrency

per_page

`/api/news`

type

`/api/entities`

Variable

Default

Free

100 requests

Suite

File

Referrer-Policy

strict-origin-when-cross-origin

get_trending_topics

API_URL

Production Vercel

Region

Sources

d

Toggle dark mode

Accessibility

Skip links, focus rings, ARIA labels

crypto-news-briefing

Generate comprehensive news briefings

Example

Language

rug-pull-news-check

Scan news for rug pull warning signs

Tutorial

Endpoints Covered

hours

`/api/trending`

threshold

`/api/clickbait`

add-data-sources

Add new RSS/API data sources

limit

All news endpoints

to

`/api/news`

style

`/api/summarize`

Layer

Technology

Polling

Portfolio updates

Strict-Transport-Security

max-age=63072000

Regulatory

`e2e/regulatory.spec.ts`

SSE

News updates, breaking alerts

X-XSS-Protection

1; mode=block

get_news_sources

List all sources

FEATURE_RELIABILITY

`true`

next-intl

Internationalization (42 languages)

Sentry

Error tracking

Husky

Git hooks

Language

Install

Swift

[`CryptoNewsSDK`](sdk/swift/)

get_ethereum_news

Ethereum-specific news

sentiment

`/api/analyze`

emerging

`/api/narratives`

i18n

`e2e/i18n.spec.ts`

Custom

Global distribution

feed

`/api/rss`, `/api/atom`

min_confidence

`/api/signals`

Method

Use Case

X-Content-Type-Options

nosniff

TradingView

`e2e/tradingview.spec.ts`

Pattern

Example

Header

Value

get_archive_stats

Archive statistics

FEATURE_SOCIAL

`true`

Parameter

Endpoints

x402

`e2e/x402.spec.ts`

find_original_sources

Original source tracking

FEATURE_PREDICTIONS

`true`

Recharts

Charts & visualizations

Grafana

Dashboards & visualization

Secretlint

Secret scanning

Ruby

`gem install fcn-sdk`

get_latest_news

Get latest cryptocurrency news

Endpoint

Description

60-300s

Static regeneration

Pro

10,000 requests

API

`e2e/api.spec.ts`

Tool

Description

get_crypto_stats

Analytics & statistics

Technology

Purpose

Inngest

Background job orchestration

Vitest

Unit testing

Feature

Description

JavaScript

`curl -O .../sdk/javascript/crypto-news.js`

Article

Topic

Enterprise

Unlimited

Home

`e2e/home.spec.ts`

get_crypto_news

analyze_news

News with sentiment analysis

FEATURE_MARKET

`true`

OpenRouter

Fallback AI routing

Playwright

E2E testing (18 spec files)

Go

`go get github.com/nirholas/free-crypto-news/sdk/go`

X-Frame-Options

SAMEORIGIN

get_breaking_news

Breaking news (last 2 hours)

get_portfolio_news

Portfolio news with prices

FEATURE_CLUSTERING

`true`

SWR

Data fetching & caching

Pino

Structured JSON logging

Zod

Runtime schema validation

Weekly

Send newsletter to subscribers

React

[`<CryptoNews />`](sdk/react/)

get_bitcoin_news

Bitcoin-specific news

search_crypto_news

Search by keywords

get_archive

Historical news archive

FEATURE_ONCHAIN

`true`

OpenTelemetry

Distributed tracing & metrics

Storybook

Component testing (60+ stories)

Job

Schedule

PHP

`curl -O .../sdk/php/CryptoNews.php`

TypeScript

`npm install @nirholas/crypto-news`

Document

What it covers

Nginx

Reverse proxy & load balancing

Stripe

Subscription billing

Java

[`crypto-news-java`](sdk/java/)

Prometheus

Metrics collection & alerting

Lighthouse

Performance auditing

Daily

Resolve prediction outcomes

Rust

`cargo add fcn-sdk`

Python

`curl -O .../sdk/python/crypto_news.py`

get_defi_news

DeFi-related news

Skill

Description

Shell

`examples/curl.sh`

from

`/api/news`

q

`/api/ask`

format

`/api/ai/brief`

Widget

Type

Fast

`askFast()`

Ticker

JavaScript

scale-to-1m

Scale the system to 1M+ requests/day

Complete

`askComplete()`

Price

Duration

source

`/api/news`

date

`/api/ai/brief`

Package

Description

market-sentiment

Analyze market sentiment across sources

page

`/api/news`

period

`/api/digest`

180-300s

Hot data

Integration

Description

6

CoinPost, CoinDesk Japan, Cointelegraph Japan, btcnews.jp, Crypto Times Japan, CoinJinja

10

8BTC, Jinse Finance, Odaily, ChainNews, PANews, TechFlow, BlockBeats, MarsBit, Wu Blockchain, Foresight News

Groq

**Supported AI Providers (priority order):** 1. **OpenAI** - `OPENAI_API_KEY` (gpt-4o-mini default) 2. **Anthropic** - `ANTHROPIC_API_KEY` (claude-3-haiku default) 3. **Groq** - `GROQ_API_KEY` (llama-3.3-70b-versatile default) ⭐ FREE 4. **OpenRouter** - `OPENROUTER_API_KEY` (llama-3-8b-instruct default) ### 🧠 RAG System (Retrieval-Augmented Generation) Production-grade question answering over crypto news using vector search + LLMs. ```typescript import { askUltimate, askFast, searchNews } from '@/lib/rag'; // Ask natural language questions const answer = await askUltimate("What happened to Bitcoin after the ETF approval?"); // Returns: answer + sources + confidence score + suggested follow-ups // Fast mode for quick queries const quick = await askFast("BTC price news"); // Search documents const results = await searchNews("Ethereum merge", { currencies: ['ETH'] }); ``` **RAG Capabilities:**

4

Arz Digital, Mihan Blockchain, Ramz Arz, Nobitex

Capability

Details

Area

Endpoints

Works Well With - Skills

revops

When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should marketing hand off to sales.' Use this for anything involving the systems and proc

1104 starsHas guide

schema

When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions "schema markup," "structured data," "JSON-LD," "rich snippets," "schema.org," "FAQ schema," "product schema," "review schema," "breadcrumb schema," "Google rich results," "knowledge panel," "star ratings in search," or "add structured data." Use this whenever someone wants their pages to show enhanced results in Google. For broader SEO issues, see seo-audit. For AI search

1104 starsHas guide

social

When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'Tik

1104 starsHas guide

referrals

When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners to bring in new customers. For launch-specific virality, see launch.

1104 starsHas guide

Works Well With - Agents

Awesome Llm Apps

100+ AI Agents, Agent Skills and RAG Apps - Free and Open Source.

138064 starscrewai

TradingAgents

TradingAgents: Multi-Agents LLM Financial Trading Framework

102713 starslangchain

Agno

Build, run, and manage agent platforms.

42172 starslangchain

Reasonix

DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.

35396 starslangchain