Mentionry

Judge whether a domain is worth running link building for at all, from live search data. Returns a verdict, the measured signals behind it, and the honest case against. This is the same free diagnostic the dashboard runs, and for a large share of sites the answer is that the niche has nothing to mine.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain to judge, for example mentionry.com"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Read a domain and return what we think it is about: a description, its audience, and the keywords it should be found for. This is the brief every other tool takes as input, so call it first when you do not already have one.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Find the domains competing with this one, from both search results and link profile overlap. Returns each candidate with the evidence for it, so a wrong suggestion can be recognised rather than trusted.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional. Sharpens the search half."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Find pages that link to the named competitors but not to you, classified by whether a link is realistically winnable and why. Competitors are excluded from their own results: a competitor is never a prospect.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "competitors": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to five competitor domains."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Search the open web for pages that would plausibly link to this site: resource pages, roundups, listicles and directories in its subject. Returns each with the reason it was kept.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "What the site does. Use read_site if you do not have one."
    },
    "audience": {
      "type": "string"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "topic": {
      "type": "string",
      "description": "Optional. Narrows the search to one theme."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false
}

Check a list of domains against your live backlink profile and report which of them now link to you, when the link first appeared, and whether it is still there. A link that was removed shows as a change rather than staying on the scoreboard.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Your domain."
    },
    "pitched": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The domains or URLs you pitched."
    }
  },
  "required": [
    "domain",
    "pitched"
  ],
  "additionalProperties": false
}

Write one outreach email for one prospect, in your own words, using the reason that prospect would link to you. It returns the subject and body and sends nothing: sending happens from your own mailbox, after you have read it. Requires a paid Mentionry plan.

{
  "type": "object",
  "properties": {
    "prospect_url": {
      "type": "string",
      "description": "The page you want the link on."
    },
    "hook": {
      "type": "string",
      "description": "Why this page would link to you."
    },
    "page_title": {
      "type": "string"
    },
    "sender_name": {
      "type": "string"
    },
    "sender_site": {
      "type": "string",
      "description": "Your domain."
    },
    "description": {
      "type": "string",
      "description": "What your site does."
    }
  },
  "required": [
    "prospect_url",
    "hook",
    "sender_site"
  ],
  "additionalProperties": false
}

The agents on this account: what each is called, how many steps it has, whether it would run as it stands, and when it last changed. Call describe_agent next to learn what one needs before running it.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

What one agent does, step by step, and what it needs: the values you must pass to run_agent, what it hands back, how many of its steps reach a vendor that charges, and anything currently stopping it from running.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "From list_agents."
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false
}

Run one of your agents once and return what every step did, in order, with what it returned and how long it took. Pass its declared inputs as an object keyed by their `key` from describe_agent. Steps that reach a paid vendor are counted against your live-sweep allowance, one each.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "From list_agents."
    },
    "inputs": {
      "type": "object",
      "description": "The agent's declared inputs, keyed by `key`. Values are strings.",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false
}

The documents your agents have produced: what each is called, which agent wrote it, how long it is and how many versions it has. Pass an id to read_document for the text.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

The text of one document your agent wrote, with the agent, the step and the values that run was given. Returns the newest version unless an older one is asked for.

{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "description": "From list_documents."
    },
    "version": {
      "type": "number",
      "description": "1 is the newest. Omit for the newest."
    }
  },
  "required": [
    "document_id"
  ],
  "additionalProperties": false
}

The account's own answer-engine measurements over a window: how often each tracked brand appears in recorded answers (visibility), its share of all mentions (share of voice), its mean position, and the ranking against named competitors. Group by day for a trend, or by model, region, persona, prompt or topic to find where a brand is weak. This is the data behind the dashboard's Answer Engine Insights.

{
  "type": "object",
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "day",
        "model",
        "region",
        "persona",
        "prompt",
        "topic"
      ],
      "description": "How to group. `day` for a trend over time; the others compare buckets."
    },
    "days": {
      "type": "number",
      "description": "Window length in days. Default 30."
    }
  },
  "required": [
    "dimension"
  ],
  "additionalProperties": false
}

Which outside tools this account has connected, and what each one is allowed to do here. Call it before offering to file, post or draft anything, so you can say what is actually available instead of guessing.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}