agishub-mcp

<div align="center">

# AgisHub

**Pay-per-call tools for AI agents — no signup, no API keys, just USDC.**

Live data & utilities over [x402](https://x402.org) micropayments on **Base**. Your agent
pays a few tenths of a cent per call from its own wallet; no accounts, no monthly plans.

![x402](https://img.shields.io/badge/x402-pay--per--call-6f42c1)
![Base](https://img.shields.io/badge/USDC-Base%20mainnet-0052ff)
![MCP](https://img.shields.io/badge/MCP-remote%20server-000000)
![License](https://img.shields.io/badge/license-MIT-green)

[Website](https://agishub.com) · [Live API](https://api.agishub.com) · [OpenAPI](https://api.agishub.com/openapi.json)

</div>

---

## Why AgisHub

Traditional APIs make an agent stop and ask a human: sign up, create an account, copy an
API key, add a credit card, read the docs. AgisHub tools are **callable the moment an agent
has a funded wallet** — the server answers `HTTP 402`, the agent signs a USDC payment on
Base, and the data flows back. Under a second, no human in the loop.

|                        | Raw API + key + plan | Single‑vendor MCP | **AgisHub** |
|------------------------|:--------------------:|:-----------------:|:-----------:|
| Sign‑up / API key      | required             | required          | **none**    |
| Billing                | monthly / credits    | subscription      | **per call (USDC)** |
| Agent can pay itself   | ✗                    | ✗                 | **✓ (x402)** |
| Free tier for discovery| varies               | varies            | **✓ (free MCP)** |
| Multiple tools, one door | ✗                  | one vendor        | **✓**       |

Free **MCP** tier to discover and prototype; pay‑per‑call **x402 HTTP** tier for production,
priced per request in USDC.

## Two doors, one platform

- **MCP (free)** — remote Model Context Protocol server. Point Claude / Cursor / any MCP
  client at the URL and the tools appear.
- **HTTP x402 (paid)** — `POST /v1/<tool>`; unpaid requests get a `402` challenge, the client
  signs a USDC payment (EIP‑3009 on Base) and retries. USDC contract `0x8335…2913`.

```
MCP (free):   https://api.agishub.com/mcp
HTTP (paid):  POST https://api.agishub.com/v1/<tool>
Discovery:    https://api.agishub.com/openapi.json
```

---

## Tools

Prices are per call in USDC on Base. Tools on both channels are **free via MCP** and priced
via **HTTP x402**.

### 🕔 timezone — world clock, date math & scheduling for agents

| Tool | What it does | Channels | Cost (x402) |
|------|--------------|:--------:|:-----------:|
| `now_in` | Current local time in an IANA timezone — UTC offset, abbreviation, DST flag. | MCP · HTTP | $0.001 |
| `convert_timezone` | Convert a datetime between two IANA zones. Accepts ISO 8601 or natural language ("next Tuesday 3pm"). | MCP · HTTP | $0.001 |
| `convert_batch` | Convert one instant into many zones at once — ideal for world‑clock views. | MCP · HTTP | $0.001 |
| `tz_offset` | Exact UTC offset of a zone at a given instant (DST‑aware; handles +05:30, +05:45). | MCP · HTTP | $0.001 |
| `lookup_timezone` | Resolve a city or country to its IANA timezone(s). "Delhi" → `Asia/Kolkata`. | MCP · HTTP | $0.001 |
| `date_math` | Add/subtract time respecting DST, or diff two datetimes across zones. | MCP · HTTP | $0.001 |
| `find_meeting_slots` | Overlapping working‑hour slots across timezones (skips weekends & public holidays). | MCP · HTTP | free: 1 slot · **$0.02**: all |
| `is_holiday` | Is a date a public holiday in a country (ISO 3166‑1)? Data from Nager.Date. | MCP · HTTP | $0.001 |
| `list_timezones` | List or search valid IANA timezone names. | MCP | free |

### 🕸️ Agis Web Scraper — read any web page as clean markdown

| Tool | What it does | Channels | Cost (x402) |
|------|--------------|:--------:|:-----------:|
| `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** |

> More tools land here as the platform grows — each new service plugs into the same MCP + x402 doors.

---

## Quick start

**Use the free MCP tools** (Claude Code example):

```bash
claude mcp add --transport http timezone https://api.agishub.com/mcp
```

**Pay per call over HTTP x402** (any x402 client / wallet):

```bash
# Unpaid → 402 challenge; an x402-aware client signs & retries automatically.
curl -X POST https://api.agishub.com/v1/web-scraper \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","render":true}'
```

Your agent's wallet only needs **USDC on Base** — the facilitator covers gas.

## For agents & LLMs

- Payments are **real USDC on Base mainnet** and **irreversible**. Fund a dedicated agent
  wallet with a small balance; that balance is your spending cap.
- The free MCP tier never charges. Only the `/v1/*` (x402 HTTP) routes take payment.
- `extract` fetches arbitrary public URLs; it will not reach private/internal hosts.

## Pricing

Per‑call, in USDC on Base — no subscription. Roughly: **$1 ≈ 1,000 timezone calls**, **≈ 250
web extractions**, or **50 full meeting‑slot searches**. Settlement fees on Base are a fraction
of a cent and paid by the facilitator.

## License

MIT © AgisHub