# Rotary Agency — AI Data Marketplace

> Pay-per-call web scraping and data API (206 endpoints) monetized with the x402 protocol. Every paid endpoint returns HTTP 402 with a PAYMENT-REQUIRED header before payment; pay USDC on Solana or Base and retry with the payment proof. Ideal for AI agents needing structured web data without API keys or subscriptions.

## Essential info

- Base URL: https://rotaryagency.uk
- Payment: USDC on Solana or Base (x402 protocol, HTTP 402 → PAYMENT-REQUIRED header)
- Machine-readable manifest: https://rotaryagency.uk/.well-known/x402.json
- Health check: https://rotaryagency.uk/health
- Pricing: $0.002–$0.10 per call depending on endpoint
- MCP server (Model Context Protocol): connect any MCP host (Claude Desktop, Cursor, etc.) to https://rotaryagency.uk/mcp — all 206 endpoints become callable tools, paid per call in USDC on Solana or Base. Server card: https://rotaryagency.uk/.well-known/mcp/server-card.json

## MCP usage

1. Add a remote MCP server to your host: URL `https://rotaryagency.uk/mcp` (streamable HTTP, no auth).
2. Every endpoint appears as a tool (e.g. `api_run` = Google Maps lead gen, `api_linkedin_person`, `api_reddit_search`, `api_free_exa`, `api_free_weather`…).
3. Call a tool → if the response says PAYMENT REQUIRED, send the exact USDC amount on Solana or Base to the listed recipient, then retry the same tool call with `paymentTxHash` set to the Solana transaction signature.

## How to call (x402 flow)

1. Request any endpoint. You receive HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON: price, network solana, recipient wallet, asset USDC).
2. Pay the exact amount in USDC on Solana or Base to the recipient address.
3. Retry your request including the payment proof (X-Payment-Signature / X-Payment-TxHash headers).
4. The server verifies the on-chain transaction (replay-protected) and returns the data.

## Endpoint groups

- **Free-source tier** (176 endpoints, $0.002/call): Exa semantic search + page fetch, YouTube transcripts + search, V2EX hot/node/topic/user, Bilibili video search, dev.to articles, OpenAlex scholarly search, PubMed, Wikipedia, Hacker News + search, GitHub, GitLab, PyPI, npm, crates.io, ArXiv, Stack Exchange, RSS reader, exchange rates, Google News headlines, stock/crypto/forex quotes (Cboe, Binance, Frankfurter), DNS lookup, OSV vulnerability check, Bitcoin network fees (mempool.space), CoinGecko prices, Open Library books, TVMaze shows, dictionary definitions, iTunes media search, NASA astronomy picture of the day, public holidays, university search, text translation, recipe search, Gutenberg books, timezones, ZIP lookup, COVID stats, advice, dog breeds, Wikiquote quotes, geocoding, QR code generation, trivia questions, jokes, Internet Archive search, name stats (age/gender/nationality), Pokemon, Rick & Morty, Wikibooks, author search, Discogs music database, MusicBrainz music metadata, Open-Meteo weather forecasts, CoinPaprika crypto, Blockchain.info BTC network stats, cat facts + breeds, ipinfo.io IP geolocation, random user profiles, Datamuse word search, Kanye quotes, ZenQuotes, Urban Dictionary slang, dad jokes, ipwho.is IP lookup, wttr.in weather, fruit nutrition, Chuck Norris jokes, PoetryDB poems, D&D 5e data, live ISS location, astronauts in space, Kraken + Bybit crypto tickers, Bored API activities, YouTube video metadata, FakeStoreAPI products, JSONPlaceholder todos + users, US National Weather Service forecasts + alerts, agify age prediction, genderize gender prediction, nationalize nationality prediction, USGS earthquakes, spaceflight news, Coinbase ticker, Crossref scholarly search, Europe PMC biomedical search, Wikidata entities, Lobsters tech news, DataCite DOIs, useless facts, deck of cards, World Bank indicators + countries, Open5e D&D 5e SRD, Wikimedia Commons search, TheAudioDB music artists, Wiktionary definitions, mailcheck email validation, KuCoin + OKX tickers, Open-Meteo geocoding, JSONPlaceholder posts/comments/albums/photos, Bible scripture, Open-Meteo air quality + marine + archive + current conditions, sunrise/sunset, ip-api, GitHub trending, trivia, Docker Hub search + tags, xkcd comics, Wikipedia pageviews, Open-Meteo elevation + flood, Met Museum + Art Institute of Chicago artworks, cocktail recipes (TheCocktailDB), 7Timer astronomy forecasts, Star Wars data (SWAPI), Game of Thrones books/characters/houses (Ice and Fire API), Kitsu anime search, Radio Browser station search, Wikivoyage travel guides, Wikinews articles, TheCatAPI breed directory, Open-Meteo solar radiation forecasts, Studio Ghibli films, SteamSpy game stats, Solana blockchain data (slot/epoch/supply), Wikisource public domain texts, Wikiversity educational resources, Photon OpenStreetMap geocoding, Ethereum blockchain data (block/gas/balance), Blockchair Bitcoin stats, Yu-Gi-Oh! card search, CheapShark game deals, color info by hex, famous quotes, Maven Central Java packages, Deezer music search, song lyrics (Lyrics.ovh), sports teams (TheSportsDB), open access journals (DOAJ), species search (Wikispecies), Digimon by name, Dragon Ball characters, Minecraft server status, riddles, NuGet .NET packages, Ruby gems, WordPress core versions, Wikimedia meta search, e-commerce products, caller IP, Zenodo research records (CERN), NIH clinical trials, FDA adverse drug event reports, EVE Online market prices, Open Brewery DB worldwide breweries, Figshare research articles.
- **Google Maps / reviews** (premium): lead generation by category + location, place details, business review search, review summaries.
- **LinkedIn** (premium): person profile, company profile, people search by title/location, company employees.
- **Reddit** (premium): search, trending, subreddit browse, thread + comments.
- **Instagram** (premium): profile, posts, audit, analyze.
- **Airbnb** (premium): search, listing details, market stats, reviews.
- **Utilities**: AI extract (prompt-based page extraction), reader (clean markdown from any URL).

## Example

```
GET https://rotaryagency.uk/api/free/exa?q=site:reddit.com AI agents
→ 402 Payment Required (PAYMENT-REQUIRED header with payment terms)
→ pay USDC on Solana or Base → retry with payment proof → JSON results
```

## Operator

Rotary Agency — AI data marketplace. 200 live endpoints, all payment-verified.