# YOOtraffic API and MCP Server

> Public read-only YOOtraffic API with prices and pages, an MCP server over Streamable HTTP, and a markdown version of every page. No key, no signup needed.

Everything this site publishes is available to programs as well as to people: a read-only JSON API, an MCP server, and a markdown representation of every page. No key, no signup, no rate limit beyond ordinary abuse protection.

## YOOtraffic Content API

A public REST API over the product catalog, the pricing model, the page index, page text, and the blog. It answers questions about the product. It does not order traffic or manage a campaign: that happens in the account application and is not exposed here.

Base URL

OpenAPI 3.1 specification

Authentication

None. Every endpoint is public, read-only, and readable cross-origin.

Response format

JSON, UTF-8, cached for five minutes at the edge.

## Endpoints

Generated from the OpenAPI document, so this list and the specification cannot disagree.

## Quick start

Three calls cover most of what an agent needs: what is sold, what it costs, and what a page says.

## MCP server

The same operations as MCP tools over the Streamable HTTP transport. Point any MCP client at the endpoint below. There is no authorization step, and the server keeps no session because every tool is a pure read.

Endpoint

Transport

Streamable HTTP (POST, JSON-RPC 2.0)

Server manifest

Client configuration

Tools

## Markdown for every page

Every page serves a markdown representation as well as HTML, so a crawler never has to parse the layout to read the text.

- Send Accept: text/markdown to any page URL and the same page comes back as markdown.
- Or append .md to the path: https://yootraffic.com/en/pricing.md
- Responses carry Vary: Accept and a Link header pointing at the markdown sibling.
- An Accept header that rejects both representations gets a 406 rather than a guess.
- A path that does not exist returns a real 404 with a markdown body listing where to go instead.

## Machine-readable files

- OpenAPI specification: https://yootraffic.com/openapi.json
- MCP server manifest: https://yootraffic.com/mcp.json
- Site summary for language models: https://yootraffic.com/llms.txt
- Pricing in markdown: https://yootraffic.com/pricing.md
- Sitemap: https://yootraffic.com/sitemap.xml
- Crawler rules: https://yootraffic.com/robots.txt

## Questions

Write to support@yootraffic.com. If an endpoint is missing something you need, say what you are building and we will look at adding it.

## Endpoints

- `GET /api/v1` (getServiceIndex): Describe the API
- `GET /api/v1/products` (listProducts): List products
- `GET /api/v1/products/{productId}` (getProduct): Get one product
- `GET /api/v1/pricing` (getPricing): Get the pricing model
- `GET /api/v1/pages` (listPages): List public pages
- `GET /api/v1/content` (getPageContent): Get a page as markdown
- `GET /api/v1/posts` (listBlogPosts): List blog posts
- `GET /api/v1/search` (searchSite): Search pages and posts

## MCP tools

- `list_products`: List every YOOtraffic product with its traffic type, billing unit, entry price, and what is included. Use this to answer what the company sells.
- `get_pricing`: Unit prices for every product plus the account terms (minimum deposit, refunds, balance expiry) and an explicit list of what the service does not deliver. Prices are USD, pay-as-you-go, no subscription. Call this instead of quoting a price from memory.
- `list_pages`: The index of every public page with its title, description, URL, and markdown URL. Use it to find the page that answers a question before fetching its text.
- `get_page_content`: The full text of any public page as markdown, including blog posts and legal documents. Give a site path such as /en/pricing or /en/blog/some-post.
- `list_blog_posts`: Published articles, newest first, with title, excerpt, date, and markdown URL.
- `search_site`: Search page titles, page descriptions, and article titles and excerpts. Returns URLs and markdown URLs so the matching text can be fetched directly.

---

- HTML version of this page: https://yootraffic.com/en/developers
- Site index for agents: https://yootraffic.com/llms.txt
- Sitemap: https://yootraffic.com/sitemap.xml
