// Use case · AI agents
For teams building agents that must answer from today’s web: one MCP endpoint or one API key, eleven tools, and each tool’s cost in the description the model reads.
MCP tools
11
credit per scraped page
1
credits per search page
2
{ "success": true, "data": { "markdown": "# Pricing\n\n…", "metadata": { "title": "Pricing - Example", "statusCode": 200 } }, "credits": 1}// Why
The problem
What Wayfern does
credits_charged.// How it works
No SDK to install and no second integration for REST: the same token and the same balance serve both.
Step 1 of 4
Create a wf_… token with the mcp scope in the dashboard. Add the web scope to use the same token over REST.
Dashboard → API tokens
Step 2 of 4
Paste the JSON config into your MCP client. Streamable HTTP, stateless: no handshake, no session header.
https://api.wayfern.com/mcp
Step 3 of 4
search_web, scrape_page, extract_data, map_site, crawl_site and six more, each with its price in the description.
tools/list → 11 tools
Step 4 of 4
Results carry credits_charged. The balance is checked again on every call.
"credits_charged": 1
// Connect
Drop the JSON into your MCP client and the whole tool list is there. Prefer plain HTTP? The other tabs run the same scrape through the REST API with the same token.
{
"mcpServers": {
"wayfern": {
"type": "http",
"url": "https://api.wayfern.com/mcp",
"headers": {
"Authorization": "Bearer ${WAYFERN_API_TOKEN}"
}
}
}
}Streamable HTTP. POST carries every message.
https://api.wayfern.com/mcp
A wf_… token with the mcp scope. The same token serves REST with the web scope. An active plan or a positive credit balance is required.
Stateless. The older session-based shape that current SDKs still speak is served on the same endpoint.
2026-07-28
// Tools and prices
This table renders from the same rate config the backend charges from, so the two cannot disagree.
| Tool | Credits | What it does |
|---|---|---|
search_web | 2 per search | Google, Bing and DuckDuckGo results with excerpts, ads, pagination and related queries. Metered per provider result page fetched. |
scrape_page | 1 per page | One page as clean markdown, HTML, links and metadata. |
extract_data | 1 per source page | Structured data from up to 100 URLs against a prompt and an optional JSON Schema. Pages already fetched are not billed again. |
map_site | 2 per 10 URLs | A site's URLs from its sitemaps and page links, optionally filtered by a search term. Billed on the URLs returned. |
crawl_site | 1 per successful page | Start a bounded multi-page crawl. Returns a job id at once and charges nothing up front. |
crawl_status | Free | Poll a crawl and read a page of its results. Pages were billed as they were crawled. |
capture_screenshot | 5 per capture | A page image with cookie banners dismissed and tall pages captured end to end. Returns a download URL. |
brand_profile | 10 per profile | Identity, colours, logos, social links and company metadata for a domain. |
site_styleguide | 10 per site | Colours, typography, spacing, radii, shadows and the design tokens a site declares. |
site_fonts | 5 per site | Font families, where each is served from, the weights available and where they are used. |
list_search_engines | Free | The live provider ids and labels that search_web accepts. |
search_web
scrape_page
extract_data
map_site
crawl_site
crawl_status
capture_screenshot
brand_profile
site_styleguide
site_fonts
list_search_engines
// What it costs
Worked from the rates above. Each box ends with how many such runs fit in the 1,520 monthly credits of the $19 Developer plan.
Search once, then read the five results worth reading.
| Item | Credits |
|---|---|
| 1 × search_web, one provider page | 2 |
| 5 × scrape_page to markdown | 5 |
Total
7credits
about $0.09
at $0.0125 / credit
About 217 runs a month on Developer ($19 for 1,520 credits).
What the design and positioning of one domain can tell you.
| Item | Credits |
|---|---|
| 1 × brand_profile | 10 |
| 1 × site_styleguide | 10 |
| 1 × site_fonts | 5 |
| 1 × capture_screenshot | 5 |
Total
30credits
about $0.38
at $0.0125 / credit
About 50 runs a month on Developer ($19 for 1,520 credits).
Discover the URLs, crawl them to markdown, poll until done.
| Item | Credits |
|---|---|
| map_site, 200 URLs returned | 40 |
| crawl_site, 200 pages crawled | 200 |
| crawl_status polling | 0 |
Total
240credits
about $3.00
at $0.0125 / credit
About 6 runs a month on Developer ($19 for 1,520 credits).
The same balance covers these tools, browser sessions, captcha solves and residential bandwidth. Every published rate is on the pricing page.
// FAQ
Any client that can connect to a remote Streamable HTTP server. Paste the JSON config with your token. The server speaks revision 2026-07-28 statelessly and also serves the older session-based shape that current SDKs still speak, on the same endpoint.
No. Each MCP tool calls the same domain service its REST endpoint calls, so validation, behaviour and billing come from one place. A tool result carries credits_charged; a REST response carries credits in the same envelope.
The nine Web Data tools state their credit cost in the description the model reads, filled in from the backend's rate config. The server's instructions add that every fetching tool spends credits and tell the model to prefer the cheapest tool that answers the question.
scrape_page, extract_data, capture_screenshot and the three site reports take a proxy option that defaults to "auto": the run goes out on a datacenter exit, and a navigation classified as blocked is retried once through a residential exit. Datacenter egress is free; residential bandwidth is metered from the same balance. Set "datacenter" or "residential" to decide yourself.
The tools cover fetch-shaped work. To sign in, step through a flow or keep one identity across many actions, drive a browser session over CDP at wss://api.wayfern.com/ws with Playwright or Puppeteer, on the same account and credit balance.
Every request checks that the account still has an active plan or a positive balance. At zero, calls are refused, unless you turned on auto top-up (off by default), which bills the overage instead.
// Keep reading
// Next step
Mint a token, paste the config, and your agent has eleven tools and one balance. Every call reports what it cost.