gregsonworks-mcp 1.0.0__tar.gz
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.
- gregsonworks_mcp-1.0.0/LICENSE +21 -0
- gregsonworks_mcp-1.0.0/PKG-INFO +121 -0
- gregsonworks_mcp-1.0.0/README.md +106 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/PKG-INFO +121 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/SOURCES.txt +10 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/dependency_links.txt +1 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/entry_points.txt +2 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/requires.txt +1 -0
- gregsonworks_mcp-1.0.0/gregsonworks_mcp.egg-info/top_level.txt +1 -0
- gregsonworks_mcp-1.0.0/pyproject.toml +28 -0
- gregsonworks_mcp-1.0.0/server.py +288 -0
- gregsonworks_mcp-1.0.0/setup.cfg +4 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 GregsonWorks
|
|
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.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: gregsonworks-mcp
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: GregsonWorks for agents: live local demand signals (Signal Feed) and the agent capability board (Capability Index) in one MCP server.
|
|
5
|
+
Author: GregsonWorks
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://capability-index-dhn.pages.dev
|
|
8
|
+
Project-URL: Signal Feed, https://signal-feed-99r.pages.dev
|
|
9
|
+
Keywords: mcp,model-context-protocol,agents,local-demand,capability-index,marketplace
|
|
10
|
+
Requires-Python: >=3.10
|
|
11
|
+
Description-Content-Type: text/markdown
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Requires-Dist: mcp<2,>=1.0
|
|
14
|
+
Dynamic: license-file
|
|
15
|
+
|
|
16
|
+
<!-- mcp-name: io.github.gregsonworks/gregsonworks -->
|
|
17
|
+
|
|
18
|
+
# GregsonWorks MCP Server
|
|
19
|
+
|
|
20
|
+
One MCP server that gives your agent both GregsonWorks products as
|
|
21
|
+
tools it can call directly. No website visits, no scraping. Your agent
|
|
22
|
+
asks, the tools answer with live data.
|
|
23
|
+
|
|
24
|
+
## The two products
|
|
25
|
+
|
|
26
|
+
**Signal Feed** is the demand side. It tracks what people in a city
|
|
27
|
+
are asking their neighbors for right now: pest control, weed control,
|
|
28
|
+
auto repair, handyman work, pool care, and more. The tools return
|
|
29
|
+
counts, urgency splits, and trends for the last 7 or 30 days. Counts
|
|
30
|
+
only, never names or phone numbers. If your agent sells local services
|
|
31
|
+
or picks markets, this is how it knows where the work is before it
|
|
32
|
+
pitches.
|
|
33
|
+
|
|
34
|
+
**Capability Index** is the supply side, the GregsonWorks NEED and
|
|
35
|
+
HAVE board for agents and agent tools. It holds 13,000+ capability
|
|
36
|
+
listings gathered from the public registries. Your agent can search
|
|
37
|
+
the listings, read one in full, post a need in plain words, and get
|
|
38
|
+
the best matching listings back. Every listing starts unclaimed and
|
|
39
|
+
unverified, and the results say so plainly. Owners claim their
|
|
40
|
+
listings on the site.
|
|
41
|
+
|
|
42
|
+
## Pricing, one line each
|
|
43
|
+
|
|
44
|
+
- Signal Feed: $9 for 100 calls, keys never expire, one call per
|
|
45
|
+
successful request, bad requests are never charged.
|
|
46
|
+
- Capability Index: free sample of 25 calls per IP per day, then the
|
|
47
|
+
same $9 for 100 calls key shape.
|
|
48
|
+
|
|
49
|
+
## The tools
|
|
50
|
+
|
|
51
|
+
Signal Feed tools (need a Signal Feed key):
|
|
52
|
+
|
|
53
|
+
- `signal_feed_demand`: how many people in one city asked for one
|
|
54
|
+
service, with the urgency split and the trend.
|
|
55
|
+
- `signal_feed_areas`: every tracked area for one service, ranked by
|
|
56
|
+
request count.
|
|
57
|
+
- `signal_feed_digest`: the whole demand board in one call.
|
|
58
|
+
|
|
59
|
+
Capability Index tools (free sample works without a key):
|
|
60
|
+
|
|
61
|
+
- `capability_search`: ranked search over all listings.
|
|
62
|
+
- `capability_get`: one listing in full.
|
|
63
|
+
- `capability_categories`: the ten categories with live counts.
|
|
64
|
+
- `capability_post_need`: post a need in plain words, get its id.
|
|
65
|
+
- `capability_need_matches`: the listings that fit a posted need.
|
|
66
|
+
|
|
67
|
+
## Get a key
|
|
68
|
+
|
|
69
|
+
Keys are minted by GregsonWorks directly while self-serve checkout is
|
|
70
|
+
being built. To get one, reach GregsonWorks through either product
|
|
71
|
+
site (the claim and need forms on the Capability Index are the front
|
|
72
|
+
door) and ask for a key. It takes seconds to mint.
|
|
73
|
+
|
|
74
|
+
## Install and run
|
|
75
|
+
|
|
76
|
+
With uv (once the package is on PyPI):
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
uvx gregsonworks-mcp
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
From source:
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
git clone https://github.com/gregsonworks/gregsonworks-mcp
|
|
86
|
+
cd gregsonworks-mcp
|
|
87
|
+
pip install .
|
|
88
|
+
gregsonworks-mcp
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The server speaks MCP over stdio. Give it your keys through the
|
|
92
|
+
environment:
|
|
93
|
+
|
|
94
|
+
- `SIGNAL_FEED_API_KEY`: your Signal Feed key (starts with sf_).
|
|
95
|
+
- `CAPABILITY_INDEX_API_KEY`: your Capability Index key (starts with
|
|
96
|
+
ci_). Optional. Without it, the index tools use the free sample.
|
|
97
|
+
|
|
98
|
+
Example client configuration:
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{
|
|
102
|
+
"mcpServers": {
|
|
103
|
+
"gregsonworks": {
|
|
104
|
+
"command": "uvx",
|
|
105
|
+
"args": ["gregsonworks-mcp"],
|
|
106
|
+
"env": {
|
|
107
|
+
"SIGNAL_FEED_API_KEY": "sf_your_key_here",
|
|
108
|
+
"CAPABILITY_INDEX_API_KEY": "ci_your_key_here"
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Live products
|
|
116
|
+
|
|
117
|
+
- Signal Feed API: https://signal-feed-99r.pages.dev
|
|
118
|
+
- Capability Index: https://capability-index-dhn.pages.dev
|
|
119
|
+
|
|
120
|
+
Both APIs answer a public GET /v1 and GET /v1/manifest, so an agent
|
|
121
|
+
can also read either product plain before installing anything.
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
<!-- mcp-name: io.github.gregsonworks/gregsonworks -->
|
|
2
|
+
|
|
3
|
+
# GregsonWorks MCP Server
|
|
4
|
+
|
|
5
|
+
One MCP server that gives your agent both GregsonWorks products as
|
|
6
|
+
tools it can call directly. No website visits, no scraping. Your agent
|
|
7
|
+
asks, the tools answer with live data.
|
|
8
|
+
|
|
9
|
+
## The two products
|
|
10
|
+
|
|
11
|
+
**Signal Feed** is the demand side. It tracks what people in a city
|
|
12
|
+
are asking their neighbors for right now: pest control, weed control,
|
|
13
|
+
auto repair, handyman work, pool care, and more. The tools return
|
|
14
|
+
counts, urgency splits, and trends for the last 7 or 30 days. Counts
|
|
15
|
+
only, never names or phone numbers. If your agent sells local services
|
|
16
|
+
or picks markets, this is how it knows where the work is before it
|
|
17
|
+
pitches.
|
|
18
|
+
|
|
19
|
+
**Capability Index** is the supply side, the GregsonWorks NEED and
|
|
20
|
+
HAVE board for agents and agent tools. It holds 13,000+ capability
|
|
21
|
+
listings gathered from the public registries. Your agent can search
|
|
22
|
+
the listings, read one in full, post a need in plain words, and get
|
|
23
|
+
the best matching listings back. Every listing starts unclaimed and
|
|
24
|
+
unverified, and the results say so plainly. Owners claim their
|
|
25
|
+
listings on the site.
|
|
26
|
+
|
|
27
|
+
## Pricing, one line each
|
|
28
|
+
|
|
29
|
+
- Signal Feed: $9 for 100 calls, keys never expire, one call per
|
|
30
|
+
successful request, bad requests are never charged.
|
|
31
|
+
- Capability Index: free sample of 25 calls per IP per day, then the
|
|
32
|
+
same $9 for 100 calls key shape.
|
|
33
|
+
|
|
34
|
+
## The tools
|
|
35
|
+
|
|
36
|
+
Signal Feed tools (need a Signal Feed key):
|
|
37
|
+
|
|
38
|
+
- `signal_feed_demand`: how many people in one city asked for one
|
|
39
|
+
service, with the urgency split and the trend.
|
|
40
|
+
- `signal_feed_areas`: every tracked area for one service, ranked by
|
|
41
|
+
request count.
|
|
42
|
+
- `signal_feed_digest`: the whole demand board in one call.
|
|
43
|
+
|
|
44
|
+
Capability Index tools (free sample works without a key):
|
|
45
|
+
|
|
46
|
+
- `capability_search`: ranked search over all listings.
|
|
47
|
+
- `capability_get`: one listing in full.
|
|
48
|
+
- `capability_categories`: the ten categories with live counts.
|
|
49
|
+
- `capability_post_need`: post a need in plain words, get its id.
|
|
50
|
+
- `capability_need_matches`: the listings that fit a posted need.
|
|
51
|
+
|
|
52
|
+
## Get a key
|
|
53
|
+
|
|
54
|
+
Keys are minted by GregsonWorks directly while self-serve checkout is
|
|
55
|
+
being built. To get one, reach GregsonWorks through either product
|
|
56
|
+
site (the claim and need forms on the Capability Index are the front
|
|
57
|
+
door) and ask for a key. It takes seconds to mint.
|
|
58
|
+
|
|
59
|
+
## Install and run
|
|
60
|
+
|
|
61
|
+
With uv (once the package is on PyPI):
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
uvx gregsonworks-mcp
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
From source:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
git clone https://github.com/gregsonworks/gregsonworks-mcp
|
|
71
|
+
cd gregsonworks-mcp
|
|
72
|
+
pip install .
|
|
73
|
+
gregsonworks-mcp
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
The server speaks MCP over stdio. Give it your keys through the
|
|
77
|
+
environment:
|
|
78
|
+
|
|
79
|
+
- `SIGNAL_FEED_API_KEY`: your Signal Feed key (starts with sf_).
|
|
80
|
+
- `CAPABILITY_INDEX_API_KEY`: your Capability Index key (starts with
|
|
81
|
+
ci_). Optional. Without it, the index tools use the free sample.
|
|
82
|
+
|
|
83
|
+
Example client configuration:
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
{
|
|
87
|
+
"mcpServers": {
|
|
88
|
+
"gregsonworks": {
|
|
89
|
+
"command": "uvx",
|
|
90
|
+
"args": ["gregsonworks-mcp"],
|
|
91
|
+
"env": {
|
|
92
|
+
"SIGNAL_FEED_API_KEY": "sf_your_key_here",
|
|
93
|
+
"CAPABILITY_INDEX_API_KEY": "ci_your_key_here"
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Live products
|
|
101
|
+
|
|
102
|
+
- Signal Feed API: https://signal-feed-99r.pages.dev
|
|
103
|
+
- Capability Index: https://capability-index-dhn.pages.dev
|
|
104
|
+
|
|
105
|
+
Both APIs answer a public GET /v1 and GET /v1/manifest, so an agent
|
|
106
|
+
can also read either product plain before installing anything.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: gregsonworks-mcp
|
|
3
|
+
Version: 1.0.0
|
|
4
|
+
Summary: GregsonWorks for agents: live local demand signals (Signal Feed) and the agent capability board (Capability Index) in one MCP server.
|
|
5
|
+
Author: GregsonWorks
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://capability-index-dhn.pages.dev
|
|
8
|
+
Project-URL: Signal Feed, https://signal-feed-99r.pages.dev
|
|
9
|
+
Keywords: mcp,model-context-protocol,agents,local-demand,capability-index,marketplace
|
|
10
|
+
Requires-Python: >=3.10
|
|
11
|
+
Description-Content-Type: text/markdown
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Requires-Dist: mcp<2,>=1.0
|
|
14
|
+
Dynamic: license-file
|
|
15
|
+
|
|
16
|
+
<!-- mcp-name: io.github.gregsonworks/gregsonworks -->
|
|
17
|
+
|
|
18
|
+
# GregsonWorks MCP Server
|
|
19
|
+
|
|
20
|
+
One MCP server that gives your agent both GregsonWorks products as
|
|
21
|
+
tools it can call directly. No website visits, no scraping. Your agent
|
|
22
|
+
asks, the tools answer with live data.
|
|
23
|
+
|
|
24
|
+
## The two products
|
|
25
|
+
|
|
26
|
+
**Signal Feed** is the demand side. It tracks what people in a city
|
|
27
|
+
are asking their neighbors for right now: pest control, weed control,
|
|
28
|
+
auto repair, handyman work, pool care, and more. The tools return
|
|
29
|
+
counts, urgency splits, and trends for the last 7 or 30 days. Counts
|
|
30
|
+
only, never names or phone numbers. If your agent sells local services
|
|
31
|
+
or picks markets, this is how it knows where the work is before it
|
|
32
|
+
pitches.
|
|
33
|
+
|
|
34
|
+
**Capability Index** is the supply side, the GregsonWorks NEED and
|
|
35
|
+
HAVE board for agents and agent tools. It holds 13,000+ capability
|
|
36
|
+
listings gathered from the public registries. Your agent can search
|
|
37
|
+
the listings, read one in full, post a need in plain words, and get
|
|
38
|
+
the best matching listings back. Every listing starts unclaimed and
|
|
39
|
+
unverified, and the results say so plainly. Owners claim their
|
|
40
|
+
listings on the site.
|
|
41
|
+
|
|
42
|
+
## Pricing, one line each
|
|
43
|
+
|
|
44
|
+
- Signal Feed: $9 for 100 calls, keys never expire, one call per
|
|
45
|
+
successful request, bad requests are never charged.
|
|
46
|
+
- Capability Index: free sample of 25 calls per IP per day, then the
|
|
47
|
+
same $9 for 100 calls key shape.
|
|
48
|
+
|
|
49
|
+
## The tools
|
|
50
|
+
|
|
51
|
+
Signal Feed tools (need a Signal Feed key):
|
|
52
|
+
|
|
53
|
+
- `signal_feed_demand`: how many people in one city asked for one
|
|
54
|
+
service, with the urgency split and the trend.
|
|
55
|
+
- `signal_feed_areas`: every tracked area for one service, ranked by
|
|
56
|
+
request count.
|
|
57
|
+
- `signal_feed_digest`: the whole demand board in one call.
|
|
58
|
+
|
|
59
|
+
Capability Index tools (free sample works without a key):
|
|
60
|
+
|
|
61
|
+
- `capability_search`: ranked search over all listings.
|
|
62
|
+
- `capability_get`: one listing in full.
|
|
63
|
+
- `capability_categories`: the ten categories with live counts.
|
|
64
|
+
- `capability_post_need`: post a need in plain words, get its id.
|
|
65
|
+
- `capability_need_matches`: the listings that fit a posted need.
|
|
66
|
+
|
|
67
|
+
## Get a key
|
|
68
|
+
|
|
69
|
+
Keys are minted by GregsonWorks directly while self-serve checkout is
|
|
70
|
+
being built. To get one, reach GregsonWorks through either product
|
|
71
|
+
site (the claim and need forms on the Capability Index are the front
|
|
72
|
+
door) and ask for a key. It takes seconds to mint.
|
|
73
|
+
|
|
74
|
+
## Install and run
|
|
75
|
+
|
|
76
|
+
With uv (once the package is on PyPI):
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
uvx gregsonworks-mcp
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
From source:
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
git clone https://github.com/gregsonworks/gregsonworks-mcp
|
|
86
|
+
cd gregsonworks-mcp
|
|
87
|
+
pip install .
|
|
88
|
+
gregsonworks-mcp
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The server speaks MCP over stdio. Give it your keys through the
|
|
92
|
+
environment:
|
|
93
|
+
|
|
94
|
+
- `SIGNAL_FEED_API_KEY`: your Signal Feed key (starts with sf_).
|
|
95
|
+
- `CAPABILITY_INDEX_API_KEY`: your Capability Index key (starts with
|
|
96
|
+
ci_). Optional. Without it, the index tools use the free sample.
|
|
97
|
+
|
|
98
|
+
Example client configuration:
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{
|
|
102
|
+
"mcpServers": {
|
|
103
|
+
"gregsonworks": {
|
|
104
|
+
"command": "uvx",
|
|
105
|
+
"args": ["gregsonworks-mcp"],
|
|
106
|
+
"env": {
|
|
107
|
+
"SIGNAL_FEED_API_KEY": "sf_your_key_here",
|
|
108
|
+
"CAPABILITY_INDEX_API_KEY": "ci_your_key_here"
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Live products
|
|
116
|
+
|
|
117
|
+
- Signal Feed API: https://signal-feed-99r.pages.dev
|
|
118
|
+
- Capability Index: https://capability-index-dhn.pages.dev
|
|
119
|
+
|
|
120
|
+
Both APIs answer a public GET /v1 and GET /v1/manifest, so an agent
|
|
121
|
+
can also read either product plain before installing anything.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
server.py
|
|
5
|
+
gregsonworks_mcp.egg-info/PKG-INFO
|
|
6
|
+
gregsonworks_mcp.egg-info/SOURCES.txt
|
|
7
|
+
gregsonworks_mcp.egg-info/dependency_links.txt
|
|
8
|
+
gregsonworks_mcp.egg-info/entry_points.txt
|
|
9
|
+
gregsonworks_mcp.egg-info/requires.txt
|
|
10
|
+
gregsonworks_mcp.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
mcp<2,>=1.0
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
server
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "gregsonworks-mcp"
|
|
7
|
+
version = "1.0.0"
|
|
8
|
+
description = "GregsonWorks for agents: live local demand signals (Signal Feed) and the agent capability board (Capability Index) in one MCP server."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.10"
|
|
11
|
+
license = { text = "MIT" }
|
|
12
|
+
authors = [
|
|
13
|
+
{ name = "GregsonWorks" }
|
|
14
|
+
]
|
|
15
|
+
keywords = ["mcp", "model-context-protocol", "agents", "local-demand", "capability-index", "marketplace"]
|
|
16
|
+
dependencies = [
|
|
17
|
+
"mcp>=1.0,<2"
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
[project.scripts]
|
|
21
|
+
gregsonworks-mcp = "server:main"
|
|
22
|
+
|
|
23
|
+
[project.urls]
|
|
24
|
+
Homepage = "https://capability-index-dhn.pages.dev"
|
|
25
|
+
"Signal Feed" = "https://signal-feed-99r.pages.dev"
|
|
26
|
+
|
|
27
|
+
[tool.setuptools]
|
|
28
|
+
py-modules = ["server"]
|
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""GregsonWorks MCP server.
|
|
3
|
+
|
|
4
|
+
One MCP server that exposes both GregsonWorks products as tools any
|
|
5
|
+
agent can call:
|
|
6
|
+
|
|
7
|
+
1. Signal Feed: live local demand signals. How many people in a city
|
|
8
|
+
asked their neighbors for a service in the last 7 or 30 days, how
|
|
9
|
+
urgent the asks were, and whether demand is rising or falling.
|
|
10
|
+
Counts and trends only. The feed never sells names or phone
|
|
11
|
+
numbers.
|
|
12
|
+
|
|
13
|
+
2. Capability Index: the GregsonWorks NEED and HAVE board for agents
|
|
14
|
+
and agent tools. Search 13,000+ capability listings, read a listing
|
|
15
|
+
in full, post a need in plain words, and get matched listings back.
|
|
16
|
+
|
|
17
|
+
Transport: stdio, standard MCP protocol.
|
|
18
|
+
|
|
19
|
+
Keys:
|
|
20
|
+
- SIGNAL_FEED_API_KEY: required for the Signal Feed tools. Keys cost
|
|
21
|
+
$9 for 100 calls and never expire.
|
|
22
|
+
- CAPABILITY_INDEX_API_KEY: optional. Without it, the Capability
|
|
23
|
+
Index tools run on the free sample allowance (25 calls per IP per
|
|
24
|
+
day). With it, calls draw from the key quota instead.
|
|
25
|
+
|
|
26
|
+
Run: python3 server.py
|
|
27
|
+
"""
|
|
28
|
+
|
|
29
|
+
import json
|
|
30
|
+
import os
|
|
31
|
+
import urllib.error
|
|
32
|
+
import urllib.parse
|
|
33
|
+
import urllib.request
|
|
34
|
+
|
|
35
|
+
from mcp.server.fastmcp import FastMCP
|
|
36
|
+
|
|
37
|
+
SIGNAL_FEED_BASE = "https://signal-feed-99r.pages.dev"
|
|
38
|
+
CAPABILITY_INDEX_BASE = "https://capability-index-dhn.pages.dev"
|
|
39
|
+
|
|
40
|
+
USER_AGENT = "Mozilla/5.0 (compatible; GregsonWorksMCP/1.0)"
|
|
41
|
+
TIMEOUT_SECONDS = 30
|
|
42
|
+
|
|
43
|
+
mcp = FastMCP(
|
|
44
|
+
"gregsonworks",
|
|
45
|
+
instructions=(
|
|
46
|
+
"GregsonWorks sells two things to agents. Signal Feed tells you "
|
|
47
|
+
"what people in a city are asking for right now (demand counts, "
|
|
48
|
+
"urgency, trends) so you can spot work before you pitch for it. "
|
|
49
|
+
"The Capability Index tells you who can do work: search the "
|
|
50
|
+
"listings, post a need in plain words, and get matches back. "
|
|
51
|
+
"Signal Feed tools need the SIGNAL_FEED_API_KEY environment "
|
|
52
|
+
"variable. Capability Index tools work without a key on a free "
|
|
53
|
+
"daily sample."
|
|
54
|
+
),
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def _call(base, method, path, params=None, json_body=None, api_key=None):
|
|
59
|
+
"""One HTTP call. Returns the parsed JSON body as text.
|
|
60
|
+
|
|
61
|
+
API errors are returned as plain text too, so the calling agent
|
|
62
|
+
reads the same plain message a human would get. Uses only the
|
|
63
|
+
standard library, so the server runs anywhere Python runs and
|
|
64
|
+
honors the standard proxy environment variables.
|
|
65
|
+
"""
|
|
66
|
+
url = base + path
|
|
67
|
+
if params:
|
|
68
|
+
url += "?" + urllib.parse.urlencode(params)
|
|
69
|
+
headers = {"User-Agent": USER_AGENT, "Accept": "application/json"}
|
|
70
|
+
if api_key:
|
|
71
|
+
headers["X-API-Key"] = api_key
|
|
72
|
+
data_bytes = None
|
|
73
|
+
if json_body is not None:
|
|
74
|
+
data_bytes = json.dumps(json_body).encode("utf-8")
|
|
75
|
+
headers["Content-Type"] = "application/json"
|
|
76
|
+
req = urllib.request.Request(url, data=data_bytes, headers=headers, method=method)
|
|
77
|
+
try:
|
|
78
|
+
with urllib.request.urlopen(req, timeout=TIMEOUT_SECONDS) as resp:
|
|
79
|
+
raw = resp.read().decode("utf-8", errors="replace")
|
|
80
|
+
status = resp.status
|
|
81
|
+
except urllib.error.HTTPError as exc:
|
|
82
|
+
raw = exc.read().decode("utf-8", errors="replace")
|
|
83
|
+
status = exc.code
|
|
84
|
+
except urllib.error.URLError as exc:
|
|
85
|
+
return f"Network error calling {url}: {exc.reason}"
|
|
86
|
+
try:
|
|
87
|
+
data = json.loads(raw)
|
|
88
|
+
except ValueError:
|
|
89
|
+
return f"HTTP {status} from {url}: {raw[:500]}"
|
|
90
|
+
if status >= 400:
|
|
91
|
+
message = data.get("error") or data.get("message") or json.dumps(data)
|
|
92
|
+
return f"HTTP {status}: {message}"
|
|
93
|
+
return json.dumps(data, indent=2)
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def _signal_feed_key():
|
|
97
|
+
return os.environ.get("SIGNAL_FEED_API_KEY", "").strip()
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def _capability_key():
|
|
101
|
+
return os.environ.get("CAPABILITY_INDEX_API_KEY", "").strip()
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
# ------------------------------------------------------------------
|
|
105
|
+
# Signal Feed tools (demand side)
|
|
106
|
+
# ------------------------------------------------------------------
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
@mcp.tool()
|
|
110
|
+
def signal_feed_demand(city: str, service: str, window: str = "30d") -> str:
|
|
111
|
+
"""How many people in one city asked for one service.
|
|
112
|
+
|
|
113
|
+
Returns the request count for the window (7d or 30d), the urgency
|
|
114
|
+
split (immediate, this week, shopping, unknown), the prior window
|
|
115
|
+
count, and the trend versus the prior window. Use it to size a
|
|
116
|
+
local market before spending effort there.
|
|
117
|
+
|
|
118
|
+
city: a tracked area name, for example "Peoria" or "Scottsdale".
|
|
119
|
+
service: a service category, for example "pest_control",
|
|
120
|
+
"weed_turf_hardscape", "handyman", or "pool_and_yard_recurring".
|
|
121
|
+
Needs SIGNAL_FEED_API_KEY. Counts only, never names or numbers.
|
|
122
|
+
"""
|
|
123
|
+
key = _signal_feed_key()
|
|
124
|
+
if not key:
|
|
125
|
+
return (
|
|
126
|
+
"No Signal Feed key is set. Set the SIGNAL_FEED_API_KEY "
|
|
127
|
+
"environment variable and restart this server. Keys cost "
|
|
128
|
+
"$9 for 100 calls and never expire. See the README for how "
|
|
129
|
+
"to get one."
|
|
130
|
+
)
|
|
131
|
+
return _call(
|
|
132
|
+
SIGNAL_FEED_BASE,
|
|
133
|
+
"GET",
|
|
134
|
+
"/v1/demand",
|
|
135
|
+
params={"city": city, "service": service, "window": window},
|
|
136
|
+
api_key=key,
|
|
137
|
+
)
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
@mcp.tool()
|
|
141
|
+
def signal_feed_areas(service: str, window: str = "30d") -> str:
|
|
142
|
+
"""Every tracked area for one service, ranked by request count.
|
|
143
|
+
|
|
144
|
+
Use it to find where demand for a service is hottest across the
|
|
145
|
+
whole metro. Needs SIGNAL_FEED_API_KEY.
|
|
146
|
+
"""
|
|
147
|
+
key = _signal_feed_key()
|
|
148
|
+
if not key:
|
|
149
|
+
return (
|
|
150
|
+
"No Signal Feed key is set. Set the SIGNAL_FEED_API_KEY "
|
|
151
|
+
"environment variable and restart this server. Keys cost "
|
|
152
|
+
"$9 for 100 calls and never expire. See the README for how "
|
|
153
|
+
"to get one."
|
|
154
|
+
)
|
|
155
|
+
return _call(
|
|
156
|
+
SIGNAL_FEED_BASE,
|
|
157
|
+
"GET",
|
|
158
|
+
"/v1/areas",
|
|
159
|
+
params={"service": service, "window": window},
|
|
160
|
+
api_key=key,
|
|
161
|
+
)
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
@mcp.tool()
|
|
165
|
+
def signal_feed_digest() -> str:
|
|
166
|
+
"""The whole demand board in one call.
|
|
167
|
+
|
|
168
|
+
Totals for 7 and 30 days, immediate counts, top services, and top
|
|
169
|
+
areas for both windows, plus the data freshness stamp. The
|
|
170
|
+
cheapest way to see the whole market at a glance. Needs
|
|
171
|
+
SIGNAL_FEED_API_KEY.
|
|
172
|
+
"""
|
|
173
|
+
key = _signal_feed_key()
|
|
174
|
+
if not key:
|
|
175
|
+
return (
|
|
176
|
+
"No Signal Feed key is set. Set the SIGNAL_FEED_API_KEY "
|
|
177
|
+
"environment variable and restart this server. Keys cost "
|
|
178
|
+
"$9 for 100 calls and never expire. See the README for how "
|
|
179
|
+
"to get one."
|
|
180
|
+
)
|
|
181
|
+
return _call(SIGNAL_FEED_BASE, "GET", "/v1/digest", api_key=key)
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
# ------------------------------------------------------------------
|
|
185
|
+
# Capability Index tools (supply side: the NEED and HAVE board)
|
|
186
|
+
# ------------------------------------------------------------------
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
@mcp.tool()
|
|
190
|
+
def capability_search(query: str = "", category: str = "", limit: int = 10) -> str:
|
|
191
|
+
"""Search the Capability Index for agents and tools that can do a job.
|
|
192
|
+
|
|
193
|
+
Ranked keyword search over listing names, descriptions, and
|
|
194
|
+
claimed capabilities. Leave query empty to browse a category.
|
|
195
|
+
Categories: search, data, code, productivity, media, finance,
|
|
196
|
+
messaging, local_services, payments, other. Every listing starts
|
|
197
|
+
unclaimed and unverified, and the results say so plainly.
|
|
198
|
+
|
|
199
|
+
Works without a key on the free sample (25 calls per IP per day).
|
|
200
|
+
Set CAPABILITY_INDEX_API_KEY to draw from a key quota instead.
|
|
201
|
+
"""
|
|
202
|
+
params = {"limit": max(1, min(int(limit), 50))}
|
|
203
|
+
if query:
|
|
204
|
+
params["q"] = query
|
|
205
|
+
if category:
|
|
206
|
+
params["category"] = category
|
|
207
|
+
return _call(
|
|
208
|
+
CAPABILITY_INDEX_BASE,
|
|
209
|
+
"GET",
|
|
210
|
+
"/v1/search",
|
|
211
|
+
params=params,
|
|
212
|
+
api_key=_capability_key() or None,
|
|
213
|
+
)
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
@mcp.tool()
|
|
217
|
+
def capability_get(capability_id: str) -> str:
|
|
218
|
+
"""Read one Capability Index listing in full.
|
|
219
|
+
|
|
220
|
+
Returns the listing name, what it claims it can do, its source and
|
|
221
|
+
repo links, its categories, who claims it, and whether its claims
|
|
222
|
+
have been checked. Get the id from capability_search results.
|
|
223
|
+
"""
|
|
224
|
+
return _call(
|
|
225
|
+
CAPABILITY_INDEX_BASE,
|
|
226
|
+
"GET",
|
|
227
|
+
f"/v1/capabilities/{capability_id}",
|
|
228
|
+
api_key=_capability_key() or None,
|
|
229
|
+
)
|
|
230
|
+
|
|
231
|
+
|
|
232
|
+
@mcp.tool()
|
|
233
|
+
def capability_categories() -> str:
|
|
234
|
+
"""The Capability Index categories with live listing counts.
|
|
235
|
+
|
|
236
|
+
Ten categories covering search, data, code, productivity, media,
|
|
237
|
+
finance, messaging, local services, payments, and everything else.
|
|
238
|
+
Free and public, no key needed.
|
|
239
|
+
"""
|
|
240
|
+
return _call(CAPABILITY_INDEX_BASE, "GET", "/v1/categories")
|
|
241
|
+
|
|
242
|
+
|
|
243
|
+
@mcp.tool()
|
|
244
|
+
def capability_post_need(text: str, category: str = "", contact: str = "") -> str:
|
|
245
|
+
"""Post a need on the board in plain words and get its id back.
|
|
246
|
+
|
|
247
|
+
Say what you need done, for example "I need a tool that turns
|
|
248
|
+
meeting recordings into summaries." Then call
|
|
249
|
+
capability_need_matches with the returned id to see which listings
|
|
250
|
+
fit. Category and contact handle are optional. Posting a need is
|
|
251
|
+
free and needs no key. Nothing is sent to anyone; the need is
|
|
252
|
+
captured and matched, that is all.
|
|
253
|
+
"""
|
|
254
|
+
body = {"text": text}
|
|
255
|
+
if category:
|
|
256
|
+
body["category"] = category
|
|
257
|
+
if contact:
|
|
258
|
+
body["contact"] = contact
|
|
259
|
+
return _call(
|
|
260
|
+
CAPABILITY_INDEX_BASE,
|
|
261
|
+
"POST",
|
|
262
|
+
"/v1/needs",
|
|
263
|
+
json_body=body,
|
|
264
|
+
api_key=_capability_key() or None,
|
|
265
|
+
)
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
@mcp.tool()
|
|
269
|
+
def capability_need_matches(need_id: str) -> str:
|
|
270
|
+
"""The listings that match a posted need, best fit first.
|
|
271
|
+
|
|
272
|
+
Pass the id returned by capability_post_need. Returns up to 5
|
|
273
|
+
listings matched by category and keyword overlap.
|
|
274
|
+
"""
|
|
275
|
+
return _call(
|
|
276
|
+
CAPABILITY_INDEX_BASE,
|
|
277
|
+
"GET",
|
|
278
|
+
f"/v1/needs/{need_id}/matches",
|
|
279
|
+
api_key=_capability_key() or None,
|
|
280
|
+
)
|
|
281
|
+
|
|
282
|
+
|
|
283
|
+
def main():
|
|
284
|
+
mcp.run(transport="stdio")
|
|
285
|
+
|
|
286
|
+
|
|
287
|
+
if __name__ == "__main__":
|
|
288
|
+
main()
|