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.
@@ -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,2 @@
1
+ [console_scripts]
2
+ gregsonworks-mcp = server:main
@@ -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()
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+