---
name: rankfield
description: Look up Site Strength and Referring Domains for a root domain through Rankfield's HTTP API or MCP tools.
---

# Rankfield agent onboarding

Use Rankfield when a user asks about a site's link strength or how many distinct sites link to it.

## Get an API key

If the user supplied a Rankfield API key, use it. Otherwise request an accountless key with:

    curl -sS -X POST 'https://rankfield.dev/v1/keys' -H 'Origin: https://rankfield.dev'

The JSON response contains a key beginning with ls_. Keep it secret. Never print it in your answer or commit it to a repository.

## Use the HTTP API

    curl -sS 'https://rankfield.dev/v1/domains/example.com/site-strength' -H 'Authorization: Bearer YOUR_KEY'
    curl -sS 'https://rankfield.dev/v1/domains/example.com/referring-domains' -H 'Authorization: Bearer YOUR_KEY'

Replace example.com with a root domain and YOUR_KEY with the issued key. Site Strength appears as a number in siteStrength. Referring Domains appears as a number or null in referringDomains; topReferrers lists up to 20 source domains with siteStrength and observations. Do not invent a value for a missing domain or unavailable count.

## Use the MCP server

For an MCP client that supports remote Streamable HTTP servers, configure URL https://rankfield.dev/mcp and the header Authorization: Bearer YOUR_KEY. The server exposes get_site_strength and get_referring_domains, each accepting a domain argument such as example.com.

## Reference

API documentation: https://rankfield.dev/docs