@alfe.ai/news-mcp 0.2.0

package/dist/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { resolveConfig } from "@alfe.ai/config";
+import { AgentApiClient } from "@alfe.ai/agent-api-client";
+import { z } from "zod";
+//#region src/tools.ts
+/**
+* MCP tool registration for the News MCP server.
+*
+* Tools:
+*   news_search    → client.newsSearch(...)    (POST /agent/news/search)
+*   top_headlines  → client.newsHeadlines(...)  (POST /agent/news/headlines)
+*
+* Both take a strict zod input schema. `provider` is an ENUM
+* (`apitube | newsdata`) defaulting to `apitube` — never free-text, because a
+* typo'd provider server-side is an unpriceable product. All provider keys and
+* billing live server-side in `services/news`; this server only forwards a
+* typed body via `@alfe.ai/agent-api-client` and normalizes errors.
+*
+* Provider / billing / HTTP errors are surfaced as an `isError` MCP result
+* carrying the error text — never a fake success.
+*/
+const providerSchema = z.enum(["apitube", "newsdata"]).default("apitube").describe("News provider to query. APITube (default) covers 500K+ sources with sentiment.");
+function ok(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data)
+	}] };
+}
+function fail(err) {
+	const message = err instanceof Error ? err.message : String(err);
+	return {
+		content: [{
+			type: "text",
+			text: JSON.stringify({ error: message })
+		}],
+		isError: true
+	};
+}
+function registerTools(server, client) {
+	const register = server.registerTool.bind(server);
+	register("news_search", {
+		description: "Search recent news across a broad provider (APITube / NewsData). Returns normalized articles with title, url, source, publishedAt, snippet, and (APITube) sentiment.",
+		inputSchema: {
+			query: z.string().min(1).describe("Search query (keywords, entities, topics)."),
+			provider: providerSchema,
+			source: z.string().optional().describe("Restrict to a single source/domain (e.g. reuters.com)."),
+			from: z.string().optional().describe("Earliest publish date, ISO-8601 (e.g. 2026-07-01)."),
+			to: z.string().optional().describe("Latest publish date, ISO-8601."),
+			language: z.string().optional().describe("ISO-639-1 language code (e.g. en)."),
+			category: z.string().optional().describe("News category (e.g. business, technology)."),
+			limit: z.number().int().positive().max(100).optional().describe("Max articles to return.")
+		}
+	}, async (args) => {
+		try {
+			return ok(await client.newsSearch({
+				query: args.query,
+				provider: args.provider,
+				source: args.source,
+				from: args.from,
+				to: args.to,
+				language: args.language,
+				category: args.category,
+				limit: args.limit
+			}));
+		} catch (err) {
+			return fail(err);
+		}
+	});
+	register("top_headlines", {
+		description: "Fetch current top headlines for a provider, optionally filtered by category, source, or language.",
+		inputSchema: {
+			provider: providerSchema,
+			category: z.string().optional().describe("News category (e.g. business, technology)."),
+			source: z.string().optional().describe("Restrict to a single source/domain."),
+			language: z.string().optional().describe("ISO-639-1 language code (e.g. en)."),
+			limit: z.number().int().positive().max(100).optional().describe("Max headlines to return.")
+		}
+	}, async (args) => {
+		try {
+			return ok(await client.newsHeadlines({
+				provider: args.provider,
+				category: args.category,
+				source: args.source,
+				language: args.language,
+				limit: args.limit
+			}));
+		} catch (err) {
+			return fail(err);
+		}
+	});
+}
+//#endregion
+//#region src/server.ts
+/**
+* News MCP Server
+*
+* Standalone stdio MCP server for broad news search (APITube / NewsData behind
+* a `provider` arg). Runtime-agnostic — spawned via `npx -y @alfe.ai/news-mcp`
+* from an integration manifest, speaks MCP over stdio, so it runs under any
+* runtime that can spawn `npx`.
+*
+* Architecture:
+*   Agent runtime ←(stdio/MCP)→ this server ←(HTTPS)→ services/news (metered)
+*
+* No provider credentials live on the box. At startup we self-fetch the agent's
+* `{ apiKey, apiUrl }` via `resolveConfig()` and call the metered `services/news`
+* Lambda through `AgentApiClient`. Provider keys + billing are server-side; the
+* Lambda is the metering chokepoint.
+*/
+function log(msg) {
+	process.stderr.write(`[news-mcp] ${msg}\n`);
+}
+async function main() {
+	const { apiKey, apiUrl } = resolveConfig();
+	const client = new AgentApiClient({
+		apiKey,
+		apiUrl
+	});
+	const server = new McpServer({
+		name: "news-mcp-server",
+		version: "0.1.0"
+	});
+	registerTools(server, client);
+	const shutdown = () => {
+		process.exit(0);
+	};
+	for (const signal of ["SIGTERM", "SIGINT"]) process.on(signal, shutdown);
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	log("News MCP server running (news_search, top_headlines)");
+}
+main().catch((err) => {
+	log(`Fatal: ${err instanceof Error ? err.message : String(err)}`);
+	process.exit(1);
+});
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@alfe.ai/news-mcp",
+  "version": "0.2.0",
+  "description": "News MCP server — broad news search (APITube / NewsData) with sentiment, metered server-side via Alfe",
+  "type": "module",
+  "main": "./dist/server.js",
+  "bin": {
+    "news-mcp-server": "./dist/server.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.0.5",
+    "@alfe.ai/agent-api-client": "0.11.0",
+    "@alfe.ai/config": "0.3.0"
+  },
+  "license": "UNLICENSED",
+  "homepage": "https://alfe.ai",
+  "author": "Alfe (https://alfe.ai)",
+  "keywords": [
+    "alfe",
+    "ai-agents",
+    "agent",
+    "llm",
+    "mcp",
+    "model-context-protocol",
+    "news"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}