AgentWire

Newswire for AI agents — A Claude-native MCP tool providing structured news/event feed

AgentWire is an MCP (Model Context Protocol) server that exposes a structured news API optimized for AI agents, not humans. It returns machine-readable news events with entities, topics, and relevance scores — perfect for Claude code agents that need fresh, reliable external signals.

🎯 Use Case

When building Claude code agents, you often need external signals:

• "What's new in AI funding this week?"
• "Any major acquisitions in the startup space?"
• "Latest developments in LLM research"

AgentWire provides structured JSON responses with entities already extracted, topics tagged, and relevance scores computed — no web scraping or parsing required.

📦 Installation

Option 1: Clone & Build (Recommended)

# Clone the repository
git clone https://github.com/luke-song/Agentwire.git
cd Agentwire

# Install dependencies
pnpm install

# Build the project
pnpm build

Option 2: NPM Install (Coming Soon)

npm install -g agentwire-mcp

Register with Claude Code

Add to your project's .mcp.json (recommended for per-project setup):

{
  "mcpServers": {
    "agentwire": {
      "command": "node",
      "args": ["/absolute/path/to/Agentwire/dist/index.js"],
      "env": {
        "AGENTWIRE_USE_REAL_NEWS": "true"
      }
    }
  }
}

Or add to ~/.claude/settings.json for global access:

{
  "mcpServers": {
    "agentwire": {
      "command": "node",
      "args": ["/absolute/path/to/Agentwire/dist/index.js"],
      "env": {
        "AGENTWIRE_USE_REAL_NEWS": "true"
      }
    }
  }
}

Important: Replace /absolute/path/to/Agentwire with your actual path (run pwd in the Agentwire directory to see it).

Note: Set AGENTWIRE_USE_REAL_NEWS to "true" for live RSS feeds, or omit for mock data.

Quick Start for Friends

One-line install:

curl -sSL https://raw.githubusercontent.com/luke-song/Agentwire/main/install.sh | bash

Or manual setup:

# 1. Clone
git clone https://github.com/luke-song/Agentwire.git ~/developer/Agentwire
cd ~/developer/Agentwire

# 2. Install & Build
pnpm install && pnpm build

# 3. Add to .mcp.json (in your project root):
echo '{
  "mcpServers": {
    "agentwire": {
      "command": "node",
      "args": ["'$(pwd)'/dist/index.js"],
      "env": { "AGENTWIRE_USE_REAL_NEWS": "true" }
    }
  }
}' > .mcp.json

# 4. Restart Claude Code and ask: "What's new in AI funding?"

🚀 Usage

Example API Call

{
  "topic": "ai funding",
  "since": "2026-07-20",
  "limit": 5
}

Example Response

{
  "events": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "timestamp": "2026-07-27T14:30:00Z",
      "source": {
        "name": "TechCrunch",
        "url": "https://techcrunch.com"
      },
      "title": "Anthropic Raises $2B in Series D Funding, Valuation Hits $40B",
      "summary": "AI safety company Anthropic has closed a $2 billion Series D...",
      "topics": ["ai", "funding", "enterprise"],
      "entities": [
        { "name": "Anthropic", "type": "company" },
        { "name": "Spark Capital", "type": "investor" },
        { "name": "Claude", "type": "product" }
      ],
      "url": "https://techcrunch.com/2026/07/27/anthropic-series-d-funding",
      "relevance_score": 0.95
    }
  ],
  "total": 8,
  "query": {
    "topic": "ai funding",
    "since": "2026-07-20",
    "limit": 5
  }
}

Claude Code Agent Example

In your Claude conversation:

User: What's new in AI funding this week?

Claude: [calls get_news({ topic: "ai funding", since: "2026-07-21", limit: 10 })]

Based on the latest news:

• Anthropic raised $2B in Series D at $40B valuation
• NeuroForge secured $150M Series B for AI chips
• NewsFlow AI got $10M seed for AI-generated news

[Full details with entities and links available...]

🛠️ Development

# Install dependencies
pnpm install

# Run in dev mode (auto-reload)
pnpm dev

# Build
pnpm build

# Start server
pnpm start

📚 API Reference

get_news

Get structured news events filtered by topic.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | topic | string | Yes | Free-form topic query (e.g. "ai funding", "startups") | | since | string | No | ISO 8601 date (YYYY-MM-DD), defaults to 7 days ago | | limit | number | No | Max results (default: 10, max: 50) |

Response:

| Field | Type | Description | |-------|------|-------------| | events | NewsEvent[] | Matching news events | | total | number | Total matching events | | query | object | Original query parameters |

NewsEvent Schema

interface NewsEvent {
  id: string;              // UUID
  timestamp: string;       // ISO 8601
  source: { name, url };
  title: string;
  summary: string;
  topics: string[];
  entities: { name, type }[];
  url: string;
  relevance_score: number; // 0-1
}

🗺️ Roadmap

• [x] Phase 1: MVP with hardcoded data
• [x] Phase 2: RSS feed integration (TechCrunch, VentureBeat, The Verge)
• [ ] Phase 3: get_trending_entities endpoint
• [ ] Phase 4: Real-time updates
• [ ] Phase 5: Custom source configuration

📄 License

MIT

Built by Luke Song — Newswire for AI agents