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.     [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