@stophy/mcp 1.2.0 → 1.3.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.
Files changed (3) hide show
  1. package/README.md +17 -17
  2. package/dist/index.js +76 -41
  3. package/package.json +36 -38
package/README.md CHANGED
@@ -2,19 +2,19 @@
2
2
 
3
3
  [![smithery badge](https://smithery.ai/badge/stophy/mcp)](https://smithery.ai/servers/stophy/mcp)
4
4
 
5
- Web scraping API for AI agents, as an MCP server. One API to search the web, read what people say, and look up products, places, jobs and homes. Pay only for answers. Your agent reaches every Stophy endpoint through three MCP tools.
5
+ Give your agents the live web over MCP. Your agent reaches every Stophy endpoint through three tools.
6
6
 
7
7
  [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=stophy&config=eyJ1cmwiOiJodHRwczovL21jcC5zdG9waHkuZGV2L21jcCJ9)
8
8
 
9
9
  ## Connect to the hosted server
10
10
 
11
- Most apps can connect to the hosted server directly. There is nothing to install.
11
+ Most apps connect to the hosted server directly, with nothing to install.
12
12
 
13
- | URL | How you connect | What your agent can use |
14
- | --- | --- | --- |
15
- | `https://api.stophy.dev/mcp` | No key | The endpoints marked `keyless: true` in the [endpoint list](https://api.stophy.dev/v1/endpoints), within a free allowance |
16
- | `https://api.stophy.dev/mcp` | `Authorization: Bearer <key>` header | Every endpoint |
17
- | `https://mcp.stophy.dev/mcp` | Sign in with your browser | Every endpoint |
13
+ | URL | How you connect | What your agent can use |
14
+ | ---------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
15
+ | `https://api.stophy.dev/mcp` | No key | The endpoints marked `keyless: true` in the [endpoint list](https://api.stophy.dev/v1/endpoints), within a free allowance |
16
+ | `https://api.stophy.dev/mcp` | `Authorization: Bearer <key>` header | Every endpoint |
17
+ | `https://mcp.stophy.dev/mcp` | Sign in with your browser | Every endpoint |
18
18
 
19
19
  Get an API key at [stophy.dev/signup](https://stophy.dev/signup).
20
20
 
@@ -104,24 +104,24 @@ To start without a key, leave out `env`.
104
104
 
105
105
  The package needs Node.js 18 or later.
106
106
 
107
- | Variable | What it does |
108
- | --- | --- |
109
- | `STOPHY_API_KEY` | Your Stophy API key. Optional. |
107
+ | Variable | What it does |
108
+ | ---------------- | ---------------------------------------------------------------------- |
109
+ | `STOPHY_API_KEY` | Your Stophy API key. Optional. |
110
110
  | `STOPHY_MCP_URL` | The server to connect to. The default is `https://api.stophy.dev/mcp`. |
111
111
 
112
112
  ## Tools
113
113
 
114
- | Tool | What it does |
115
- | --- | --- |
116
- | `stophy_search_endpoints` | Finds the endpoint for a task, with its cost |
117
- | `stophy_describe_endpoint` | Shows the input an endpoint takes and what it returns |
118
- | `stophy_call` | Runs an endpoint with `id`, `input` and optional `fields`, and returns JSON |
114
+ | Tool | What it does |
115
+ | -------------------------- | --------------------------------------------------------------------------- |
116
+ | `stophy_search_endpoints` | Finds the endpoint for a task, with its cost |
117
+ | `stophy_describe_endpoint` | Shows the input an endpoint takes and what it returns |
118
+ | `stophy_call` | Runs an endpoint with `id`, `input` and optional `fields`, and returns JSON |
119
119
 
120
- Your agent usually searches, then describes, then calls. Endpoint ids are camelCase, such as `googleSearch` or `youtubeSearch`. Lists come back as `results`, and `fields` keeps only the keys you name on each row. Each result says how many credits it used.
120
+ Your agent usually searches, then describes, then calls. Endpoint ids are camelCase, such as `googleSearch` or `youtubeSearch`. Lists come back as `results`, and `fields` keeps only the keys you name on each row. Each result says what it cost.
121
121
 
122
122
  To point at one thing, send its link or its id, never both: `videoUrl` or `videoId`, `placeUrl` or `placeId`, `userUrl` or `username`. The endpoint description lists the pair.
123
123
 
124
- One call returns one page from the site at the price shown for that endpoint. Most calls cost 1 credit, some cost 2, and long lists cost 1 credit per 10 results. Some list endpoints take `page` and return `page`: ask for the next number, and stop when `results` comes back empty. Others return a `cursor` when there is more: pass it back unchanged as `cursor` to get the next page.
124
+ One call returns one page from the site. Most calls cost $0.0015, long lists cost $0.0015 per 10 results, and a few cost more. See [pricing](https://docs.stophy.dev/billing). Some list endpoints take `page` and return `page`: ask for the next number, and stop when `results` comes back empty. Others return a `cursor` when there is more: pass it back unchanged as `cursor` to get the next page.
125
125
 
126
126
  ## Network and credentials
127
127