@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 +21 -0
- package/README.md +159 -0
- package/bin/cli.js +17 -0
- package/package.json +32 -0
- package/server.json +18 -0
- package/src/index.ts +1111 -0
- package/src/server.ts +45 -0
- package/tsconfig.json +18 -0
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
|
+
}
|