@agishub/mcp 2.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 +117 -0
- package/dist/stdio.js +33186 -0
- package/package.json +71 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 AgisHub (agishub.com)
|
|
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,117 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# AgisHub
|
|
4
|
+
|
|
5
|
+
**Pay-per-call tools for AI agents — no signup, no API keys, just USDC.**
|
|
6
|
+
|
|
7
|
+
Live data & utilities over [x402](https://x402.org) micropayments on **Base**. Your agent
|
|
8
|
+
pays a few tenths of a cent per call from its own wallet; no accounts, no monthly plans.
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
[Website](https://agishub.com) · [Live API](https://api.agishub.com) · [OpenAPI](https://api.agishub.com/openapi.json)
|
|
16
|
+
|
|
17
|
+
</div>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## Why AgisHub
|
|
22
|
+
|
|
23
|
+
Traditional APIs make an agent stop and ask a human: sign up, create an account, copy an
|
|
24
|
+
API key, add a credit card, read the docs. AgisHub tools are **callable the moment an agent
|
|
25
|
+
has a funded wallet** — the server answers `HTTP 402`, the agent signs a USDC payment on
|
|
26
|
+
Base, and the data flows back. Under a second, no human in the loop.
|
|
27
|
+
|
|
28
|
+
| | Raw API + key + plan | Single‑vendor MCP | **AgisHub** |
|
|
29
|
+
|------------------------|:--------------------:|:-----------------:|:-----------:|
|
|
30
|
+
| Sign‑up / API key | required | required | **none** |
|
|
31
|
+
| Billing | monthly / credits | subscription | **per call (USDC)** |
|
|
32
|
+
| Agent can pay itself | ✗ | ✗ | **✓ (x402)** |
|
|
33
|
+
| Free tier for discovery| varies | varies | **✓ (free MCP)** |
|
|
34
|
+
| Multiple tools, one door | ✗ | one vendor | **✓** |
|
|
35
|
+
|
|
36
|
+
Free **MCP** tier to discover and prototype; pay‑per‑call **x402 HTTP** tier for production,
|
|
37
|
+
priced per request in USDC.
|
|
38
|
+
|
|
39
|
+
## Two doors, one platform
|
|
40
|
+
|
|
41
|
+
- **MCP (free)** — remote Model Context Protocol server. Point Claude / Cursor / any MCP
|
|
42
|
+
client at the URL and the tools appear.
|
|
43
|
+
- **HTTP x402 (paid)** — `POST /v1/<tool>`; unpaid requests get a `402` challenge, the client
|
|
44
|
+
signs a USDC payment (EIP‑3009 on Base) and retries. USDC contract `0x8335…2913`.
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
MCP (free): https://api.agishub.com/mcp
|
|
48
|
+
HTTP (paid): POST https://api.agishub.com/v1/<tool>
|
|
49
|
+
Discovery: https://api.agishub.com/openapi.json
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Tools
|
|
55
|
+
|
|
56
|
+
Prices are per call in USDC on Base. Tools on both channels are **free via MCP** and priced
|
|
57
|
+
via **HTTP x402**.
|
|
58
|
+
|
|
59
|
+
### 🕔 timezone — world clock, date math & scheduling for agents
|
|
60
|
+
|
|
61
|
+
| Tool | What it does | Channels | Cost (x402) |
|
|
62
|
+
|------|--------------|:--------:|:-----------:|
|
|
63
|
+
| `now_in` | Current local time in an IANA timezone — UTC offset, abbreviation, DST flag. | MCP · HTTP | $0.001 |
|
|
64
|
+
| `convert_timezone` | Convert a datetime between two IANA zones. Accepts ISO 8601 or natural language ("next Tuesday 3pm"). | MCP · HTTP | $0.001 |
|
|
65
|
+
| `convert_batch` | Convert one instant into many zones at once — ideal for world‑clock views. | MCP · HTTP | $0.001 |
|
|
66
|
+
| `tz_offset` | Exact UTC offset of a zone at a given instant (DST‑aware; handles +05:30, +05:45). | MCP · HTTP | $0.001 |
|
|
67
|
+
| `lookup_timezone` | Resolve a city or country to its IANA timezone(s). "Delhi" → `Asia/Kolkata`. | MCP · HTTP | $0.001 |
|
|
68
|
+
| `date_math` | Add/subtract time respecting DST, or diff two datetimes across zones. | MCP · HTTP | $0.001 |
|
|
69
|
+
| `find_meeting_slots` | Overlapping working‑hour slots across timezones (skips weekends & public holidays). | MCP · HTTP | free: 1 slot · **$0.02**: all |
|
|
70
|
+
| `is_holiday` | Is a date a public holiday in a country (ISO 3166‑1)? Data from Nager.Date. | MCP · HTTP | $0.001 |
|
|
71
|
+
| `list_timezones` | List or search valid IANA timezone names. | MCP | free |
|
|
72
|
+
|
|
73
|
+
### 🕸️ Agis Web Scraper — read any web page as clean markdown
|
|
74
|
+
|
|
75
|
+
| Tool | What it does | Channels | Cost (x402) |
|
|
76
|
+
|------|--------------|:--------:|:-----------:|
|
|
77
|
+
| `extract` | Fetch any public URL and return its main content as clean markdown (title, headings, links, lists). Optional `render:true` runs a headless browser for JS‑heavy pages / SPAs. Built for RAG and agents that need to read the web. | HTTP | **$0.004** |
|
|
78
|
+
|
|
79
|
+
> More tools land here as the platform grows — each new service plugs into the same MCP + x402 doors.
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Quick start
|
|
84
|
+
|
|
85
|
+
**Use the free MCP tools** (Claude Code example):
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
claude mcp add --transport http timezone https://api.agishub.com/mcp
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
**Pay per call over HTTP x402** (any x402 client / wallet):
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
# Unpaid → 402 challenge; an x402-aware client signs & retries automatically.
|
|
95
|
+
curl -X POST https://api.agishub.com/v1/web-scraper \
|
|
96
|
+
-H 'content-type: application/json' \
|
|
97
|
+
-d '{"url":"https://example.com","render":true}'
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Your agent's wallet only needs **USDC on Base** — the facilitator covers gas.
|
|
101
|
+
|
|
102
|
+
## For agents & LLMs
|
|
103
|
+
|
|
104
|
+
- Payments are **real USDC on Base mainnet** and **irreversible**. Fund a dedicated agent
|
|
105
|
+
wallet with a small balance; that balance is your spending cap.
|
|
106
|
+
- The free MCP tier never charges. Only the `/v1/*` (x402 HTTP) routes take payment.
|
|
107
|
+
- `extract` fetches arbitrary public URLs; it will not reach private/internal hosts.
|
|
108
|
+
|
|
109
|
+
## Pricing
|
|
110
|
+
|
|
111
|
+
Per‑call, in USDC on Base — no subscription. Roughly: **$1 ≈ 1,000 timezone calls**, **≈ 250
|
|
112
|
+
web extractions**, or **50 full meeting‑slot searches**. Settlement fees on Base are a fraction
|
|
113
|
+
of a cent and paid by the facilitator.
|
|
114
|
+
|
|
115
|
+
## License
|
|
116
|
+
|
|
117
|
+
MIT © AgisHub
|