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
}

Make one picture from a description: a product shot, a social visual, hero art, an ad creative, an illustration for a page or an email. Returns its public address, which write_landing_page and write_email_template accept and which you link to in your reply; the product draws it under this tool's row. Spends one image allowance (quality 'best' costs about five times more; use it only when asked).

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "What to draw, specifically: subject, setting, style, lighting, colours, mood. Name the brand's colours when you know them. No text inside the image unless asked."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3"
      ],
      "description": "Default 1:1. 16:9 for a hero, 9:16 for a story, 4:3 for a card."
    },
    "quality": {
      "type": "string",
      "enum": [
        "fast",
        "best"
      ],
      "description": "Default fast."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

Make one short clip (three to eight seconds; 480p by default, 720p with quality 'best' at several times the cost) from a description, optionally animating a picture generate_image already made by passing its address as first_frame_url. Renders in one to two minutes and returns its public address; the product plays it under this tool's row. Spends one video allowance, the dearest single action here, so confirm the description with the customer before calling it. Requires a paid Mentionry plan.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The motion and the scene: what moves, camera, pace, mood."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "description": "Default 16:9. 9:16 for a story or a reel."
    },
    "seconds": {
      "type": "integer",
      "minimum": 3,
      "maximum": 8,
      "description": "Default 5."
    },
    "first_frame_url": {
      "type": "string",
      "description": "Optional. The /m/... address of a generated picture to animate."
    },
    "quality": {
      "type": "string",
      "enum": [
        "fast",
        "best"
      ],
      "description": "Default fast."
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false
}

The pictures and clips already generated on this account, newest first, with their addresses. Free.

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

Write a complete, responsive landing page as HTML from a brief and file it in Documents, where the customer previews it. Grounded in the brand kit when one exists. Pass the addresses of pictures you generated so the page uses them. It is private until publish_page. Spends one draft allowance.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The page's name in Documents and its <title>."
    },
    "goal": {
      "type": "string",
      "description": "What the page must make the reader do, in one sentence."
    },
    "audience": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The sections wanted, in order, each in a few words."
    },
    "offer": {
      "type": "string"
    },
    "cta_text": {
      "type": "string"
    },
    "cta_url": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "/m/... addresses from generate_image, in the order to use them."
    },
    "tone": {
      "type": "string"
    },
    "notes": {
      "type": "string",
      "description": "Anything else to honour: colours, length, what to avoid."
    }
  },
  "required": [
    "title",
    "goal"
  ],
  "additionalProperties": false
}

Write a complete HTML marketing email (tables and inline styles, so it renders in Outlook and Gmail) from a brief and file it in Documents for preview. Grounded in the brand kit when one exists. The result can go into the customer's Gmail drafts with create_email_draft or be sent through an app action, both of which ask first. Spends one draft allowance.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The template's name in Documents and the subject line."
    },
    "goal": {
      "type": "string"
    },
    "audience": {
      "type": "string"
    },
    "preheader": {
      "type": "string"
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "offer": {
      "type": "string"
    },
    "cta_text": {
      "type": "string"
    },
    "cta_url": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "/m/... addresses from generate_image."
    },
    "tone": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "title",
    "goal"
  ],
  "additionalProperties": false
}