@pipeworx/mcp-newswire-com 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Mojibake Inc.
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,159 @@
1
+ # @pipeworx/newswire-com
2
+
3
+ Live press releases from Newswire.com's public newsroom RSS feed — headline,
4
+ publish time and sub-headline excerpt, newest first, for the 50 most recent
5
+ releases. Newswire.com is an Issuer Direct wire, sibling to ACCESS Newswire,
6
+ and carries a large share of the same releases.
7
+
8
+ Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1679+ live data sources.
9
+
10
+ ## Tools
11
+
12
+ - `newswire_com_latest_releases(since_hours?, limit?)` — the current rolling
13
+ window of releases, newest first (up to 50). `newest_item_at` tells a
14
+ caller whether the feed is quiet or stalled.
15
+ - `newswire_com_search_releases(query, limit?)` — keyword/company match over
16
+ headline and excerpt, within the current window only.
17
+ - `newswire_com_get_release(url)` — one specific release, matched by the URL
18
+ a prior call returned. Fails clearly (not silently empty) if the release
19
+ has scrolled out of the current window.
20
+
21
+ ## Auth
22
+
23
+ Keyless. No account, no clickthrough terms. `newswire.com/robots.txt`
24
+ disallows only the per-tag feeds and asks for `Crawl-delay: 5`; the
25
+ gateway's per-call result cache keeps polling well below that.
26
+
27
+ ## Data sources
28
+
29
+ - <https://www.newswire.com/newsroom/rss> — the newsroom "Press Releases"
30
+ channel. Measured 2026-09-22: 50 items spanning roughly a day.
31
+
32
+ Every call re-fetches this same rolling 50-item window live — it is **not**
33
+ an archive. `search_releases` only ever searches what is currently in the
34
+ window and `get_release` can miss something that has already fallen out of
35
+ it (the tool says so explicitly rather than returning an empty result).
36
+
37
+ This feed carries **no issuer field** — the company name lives only in the
38
+ headline or sub-headline — so `issuer` is `null` on every row rather than a
39
+ guess parsed out of the headline.
40
+
41
+ The `/feeds` index page lists ~650 per-beat feeds
42
+ (`/newsroom/rss/beat/<slug>`) and two "custom" feeds; every beat probed
43
+ returned a bare nginx 404 and both custom feeds return HTTP 410 Gone
44
+ (2026-09-22), so this pack does not enumerate them.
45
+
46
+ ### Relationship to ACCESS Newswire
47
+
48
+ ACCESS Newswire (formerly ACCESSWIRE) serves every feed path (`/users/rss`,
49
+ `/rss`, `/rss.xml`, its sitemap index) and every article page behind a
50
+ Cloudflare managed challenge (HTTP 403, `cf-mitigated: challenge`); its only
51
+ open feeds, `/feed/rss2` and `/feed/atom`, are its corporate blog, not the
52
+ wire. Measured 2026-09-22: 12 of the 20 releases on ACCESS Newswire's
53
+ newsroom landing page appeared verbatim in this feed. This pack is therefore
54
+ the closest keyless, machine-readable surface to that wire — partial, not a
55
+ mirror (fleet #2286).
56
+
57
+ ## Quick Start
58
+
59
+ Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
60
+
61
+ ```json
62
+ {
63
+ "mcpServers": {
64
+ "newswire-com": {
65
+ "url": "https://gateway.pipeworx.io/newswire-com/mcp"
66
+ }
67
+ }
68
+ }
69
+ ```
70
+
71
+ ### What this endpoint actually serves
72
+
73
+ `tools/list` at `https://gateway.pipeworx.io/newswire-com/mcp` returns the tools in the table
74
+ above **plus the shared Pipeworx meta-tools** — `ask_pipeworx`,
75
+ `discover_tools`, `search_within`, `remember`/`recall` and the rest of the
76
+ gateway-wide set. So the tool count you see is larger than this table: a
77
+ single-pack endpoint currently lists roughly 30 shared tools alongside the
78
+ pack's own. The connection's `initialize` response states its exact scope, and
79
+ is the authoritative answer for a given day.
80
+
81
+ This is deliberate, not multiplexing by accident. The meta-tools are what let a
82
+ scoped connection answer a question this pack does not cover — via
83
+ `ask_pipeworx`, which routes across the whole catalog — without you adding a
84
+ second MCP server. There is currently no way to mount a pack endpoint without
85
+ them; if the extra schemas cost you more context than the routing is worth,
86
+ connect to the full gateway once rather than to several pack endpoints.
87
+
88
+ Or connect to the full Pipeworx gateway to get every pack's tools listed
89
+ directly, instead of just this one's:
90
+
91
+ ```json
92
+ {
93
+ "mcpServers": {
94
+ "pipeworx": {
95
+ "url": "https://gateway.pipeworx.io/mcp"
96
+ }
97
+ }
98
+ }
99
+ ```
100
+
101
+ Both URLs reach the same gateway and the same 1679+ data sources. The
102
+ only difference is which pack's tools are listed **directly**; `ask_pipeworx`
103
+ reaches all of them from either one.
104
+
105
+ ## No MCP client? Call it over HTTP
106
+
107
+ ```bash
108
+ curl -X POST https://gateway.pipeworx.io/v1/tools/newswire_com_latest_releases \
109
+ -H 'Content-Type: application/json' \
110
+ -d '{}'
111
+ ```
112
+
113
+ No account needed for the first calls. Inspect any tool: `GET https://gateway.pipeworx.io/v1/tools/newswire_com_latest_releases`. Find one: `POST https://gateway.pipeworx.io/v1/tools/search_packs` with `{"query":"..."}`.
114
+
115
+ ## Standalone (no gateway account)
116
+
117
+ This package also runs as a local stdio MCP server — no Pipeworx account, no
118
+ gateway round-trip:
119
+
120
+ ```json
121
+ {
122
+ "mcpServers": {
123
+ "newswire-com": {
124
+ "command": "npx",
125
+ "args": ["-y", "@pipeworx/mcp-newswire-com"]
126
+ }
127
+ }
128
+ }
129
+ ```
130
+
131
+ Or run it directly to confirm it starts:
132
+
133
+ ```bash
134
+ npx -y @pipeworx/mcp-newswire-com
135
+ ```
136
+
137
+ It speaks MCP over stdin/stdout and answers `initialize`/`tools/list`/`tools/call`
138
+ for **only** this pack's tools — none of the shared meta-tools the gateway
139
+ connection above adds. Same source, same tools, no ask_pipeworx routing.
140
+
141
+ ## Using with ask_pipeworx
142
+
143
+ Instead of calling tools directly, you can ask questions in plain English —
144
+ this works on the pack endpoint above as well as on the full gateway:
145
+
146
+ ```
147
+ ask_pipeworx({ question: "your question about Newswire Com data" })
148
+ ```
149
+
150
+ The gateway picks the right tool and fills the arguments automatically.
151
+
152
+ ## More
153
+
154
+ - [Docs and guides](https://pipeworx.io/docs)
155
+ - [pipeworx.io](https://pipeworx.io)
156
+
157
+ ## License
158
+
159
+ MIT
package/bin/cli.js ADDED
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ //
3
+ // Entry point for `npx @pipeworx/mcp-<slug>`.
4
+ //
5
+ // Packs ship as raw TypeScript (no build step — see publish-pack.sh for why:
6
+ // tsx sidesteps every extensionless-import / bare-JSON-import edge case a
7
+ // per-pack tsc build would have to solve one pack at a time). This file
8
+ // registers tsx's ESM loader programmatically, then hands off to src/server.ts,
9
+ // which wraps the pack's {tools, callTool} export in a stdio MCP server.
10
+ //
11
+ // Copied verbatim into every published pack repo by scripts/publish-pack.sh —
12
+ // edit this file, not a per-pack copy.
13
+ import { register } from 'tsx/esm/api';
14
+
15
+ register();
16
+
17
+ await import('../src/server.ts');
package/package.json ADDED
@@ -0,0 +1,32 @@
1
+ {
2
+ "name": "@pipeworx/mcp-newswire-com",
3
+ "version": "0.1.0",
4
+ "description": "Newswire.com MCP — press releases from Newswire's public newsroom feed.",
5
+ "type": "module",
6
+ "main": "src/index.ts",
7
+ "types": "src/index.ts",
8
+ "bin": {
9
+ "mcp-newswire-com": "bin/cli.js"
10
+ },
11
+ "keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "newswire-com"],
12
+ "license": "MIT",
13
+ "repository": {
14
+ "type": "git",
15
+ "url": "git+https://github.com/pipeworx-io/mcp-newswire-com.git"
16
+ },
17
+ "scripts": {
18
+ "typecheck": "tsc --noEmit"
19
+ },
20
+ "dependencies": {
21
+ "@modelcontextprotocol/sdk": "^1.30.0",
22
+ "tsx": "^4.19.0"
23
+ },
24
+ "devDependencies": {
25
+ "typescript": "^5.9.3",
26
+ "@cloudflare/workers-types": "^4.20260405.1"
27
+ },
28
+ "pipeworx": {
29
+ "sourceHash": "v1-8e084c3b1e7f6b0fbd48fe9792933caef38a8f4aed5fbb5646e9e4c7b05bcb45",
30
+ "sourceCommit": "b0fb3c31386cf0256dcf1e2f1b3440435a87ec35"
31
+ }
32
+ }
package/server.json ADDED
@@ -0,0 +1,18 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.pipeworx-io/newswire-com",
4
+ "title": "Newswire Com",
5
+ "description": "Newswire.com MCP — press releases from Newswire's public newsroom feed.",
6
+ "version": "0.1.0",
7
+ "websiteUrl": "https://pipeworx.io/packs/newswire-com",
8
+ "repository": {
9
+ "url": "https://github.com/pipeworx-io/mcp-newswire-com",
10
+ "source": "github"
11
+ },
12
+ "remotes": [
13
+ {
14
+ "type": "streamable-http",
15
+ "url": "https://gateway.pipeworx.io/newswire-com/mcp"
16
+ }
17
+ ]
18
+ }