Skip to main content

GregsonWorks MCP Server

One MCP server that gives your agent both GregsonWorks products as tools it can call directly. No website visits, no scraping. Your agent asks, the tools answer with live data.

The two products

Signal Feed is the demand side. It tracks what people in a city are asking their neighbors for right now: pest control, weed control, auto repair, handyman work, pool care, and more. The tools return counts, urgency splits, and trends for the last 7 or 30 days. Counts only, never names or phone numbers. If your agent sells local services or picks markets, this is how it knows where the work is before it pitches.

Capability Index is the supply side, the GregsonWorks NEED and HAVE board for agents and agent tools. It holds 13,000+ capability listings gathered from the public registries. Your agent can search the listings, read one in full, post a need in plain words, and get the best matching listings back. Every listing starts unclaimed and unverified, and the results say so plainly. Owners claim their listings on the site.

Pricing, one line each

  • Signal Feed: $9 for 100 calls, keys never expire, one call per successful request, bad requests are never charged.
  • Capability Index: free sample of 25 calls per IP per day, then the same $9 for 100 calls key shape.

The tools

Signal Feed tools (need a Signal Feed key):

  • signal_feed_demand: how many people in one city asked for one service, with the urgency split and the trend.
  • signal_feed_areas: every tracked area for one service, ranked by request count.
  • signal_feed_digest: the whole demand board in one call.

Capability Index tools (free sample works without a key):

  • capability_search: ranked search over all listings.
  • capability_get: one listing in full.
  • capability_categories: the ten categories with live counts.
  • capability_post_need: post a need in plain words, get its id.
  • capability_need_matches: the listings that fit a posted need.

Get a key

Keys are minted by GregsonWorks directly while self-serve checkout is being built. To get one, reach GregsonWorks through either product site (the claim and need forms on the Capability Index are the front door) and ask for a key. It takes seconds to mint.

Install and run

With uv (once the package is on PyPI):

uvx gregsonworks-mcp

From source:

git clone https://github.com/gregsonworks/gregsonworks-mcp
cd gregsonworks-mcp
pip install .
gregsonworks-mcp

The server speaks MCP over stdio. Give it your keys through the environment:

  • SIGNAL_FEED_API_KEY: your Signal Feed key (starts with sf_).
  • CAPABILITY_INDEX_API_KEY: your Capability Index key (starts with ci_). Optional. Without it, the index tools use the free sample.

Example client configuration:

{
  "mcpServers": {
    "gregsonworks": {
      "command": "uvx",
      "args": ["gregsonworks-mcp"],
      "env": {
        "SIGNAL_FEED_API_KEY": "sf_your_key_here",
        "CAPABILITY_INDEX_API_KEY": "ci_your_key_here"
      }
    }
  }
}

Live products

Both APIs answer a public GET /v1 and GET /v1/manifest, so an agent can also read either product plain before installing anything.

Metadata

Release files for gregsonworks-mcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gregsonworks-mcp 1.0.0
File Size Uploaded Provenance Actions
gregsonworks_mcp-1.0.0.tar.gz 6.6 kB Without provenance Details for gregsonworks_mcp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gregsonworks-mcp 1.0.0
File Interpreter ABI Platform Actions
gregsonworks_mcp-1.0.0-py3-none-any.whl Python 3 none any Details for gregsonworks_mcp-1.0.0-py3-none-any.whl

Total release size: 13.9 kB

Release files / gregsonworks_mcp-1.0.0.tar.gz

Download URL gregsonworks_mcp-1.0.0.tar.gz
Size 6.6 kB
Tags Source
SHA-256 checksum
How to use checksums
8470f8393edba69f488de9964b025a4c322906e149689f653bdfcac61022f9c0
BLAKE2b-256 checksum
How to use checksums
94105d9db82f59c153ac6499c89ef3262a64bb1aefad89ae24157cbd795f128b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / gregsonworks_mcp-1.0.0-py3-none-any.whl

Download URL gregsonworks_mcp-1.0.0-py3-none-any.whl
Size 7.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1eb2aecb03d710421d8e58fed27e3f0abd85644db5688f3844793e00771e494b
BLAKE2b-256 checksum
How to use checksums
ef96e16fb38a1000e57051032709676f4cf2c0d87d26724aabe0603364b34847
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Security for gregsonworks-mcp 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page