The Agents Index

Full-text search over The Agents Index's Published agents. Returns compact records (name, slug, tagline, url). Fetch depth with get_listing.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to search for."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10, cap 25)."
    }
  },
  "required": [
    "query"
  ]
}

One agent in full, as answer-first markdown: the summary, then every question on the sheet with its answer, the vendor's own words for it and the URL that proves it. Identical to /{slug}.md and to the HTML page.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The listing slug (from search_listings or the URL)."
    }
  },
  "required": [
    "slug"
  ]
}

The Agents Index's taxonomy with live listing counts.

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

Two agents side by side, as markdown: taglines, pricing, API availability, tags — the researched compare facts, honest about unknowns.

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "First listing slug."
    },
    "b": {
      "type": "string",
      "description": "Second listing slug."
    }
  },
  "required": [
    "a",
    "b"
  ]
}

The Published agents in one category, ranked (paid tiers first, then editorial merit), as a markdown answer sheet.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "The category slug (from list_categories)."
    }
  },
  "required": [
    "category"
  ]
}

Submit an agent to The Agents Index: url + name (+ optional note). Requires an existing signed-in account with verified email; send its session Cookie header on the MCP request. Identity and email come only from that session. Sign in or explicitly create an account at https://theagentsindex.com/login?next=%2Fsubmit and verify its email before retrying. This tool creates no account and sends no verification email. Returns {httpStatus:201, id, slug, status:'Draft'}; research + the quality gate decide publication. Your own (url, session email) replay within 24h returns httpStatus:200. Track progress at GET /api/submissions/{id}. No session: {httpStatus:401, error:'sign_in_required', message, loginUrl}. Unverified session: {httpStatus:403, error:'email_unverified', message, email, remediation}. Company gate: the account's address, or an address it proved with a code, must be on the submitted website's domain; otherwise {httpStatus:403, error:'domain_unverified', message, domain, remediation} — POST /api/domain-proof/start {url, email} mails a 6-digit code to an address at that domain, POST /api/domain-proof/verify {proofId, code} redeems it, then submit again. Personal mailboxes (gmail, outlook…) never prove a domain. No refusal creates a listing. Validation returns 400; duplicate/claim responses return 409. Read tools remain keyless.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The website being submitted (https)."
    },
    "name": {
      "type": "string",
      "description": "Its name (2–120 chars)."
    },
    "note": {
      "type": "string",
      "description": "Optional context for the editors (≤1000 chars)."
    }
  },
  "required": [
    "url",
    "name"
  ]
}

Send a buyer-intent enquiry (lead) to an agent or a whole category on The Agents Index. Keyless. Requires consent:true, a real name, a permanent (non-disposable) email, a message of at least 20 chars, and a target (listingSlug OR categorySlug). Returns { ok, delivered }. Idempotent by (email, target) within 7 days. Nothing here changes a listing's rank, tier or copy.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Your name."
    },
    "email": {
      "type": "string",
      "description": "A permanent contact email (non-disposable)."
    },
    "message": {
      "type": "string",
      "description": "The enquiry — real demand, at least 20 chars."
    },
    "consent": {
      "type": "boolean",
      "description": "Must be true — you agree your details go to the provider(s)."
    },
    "listingSlug": {
      "type": "string",
      "description": "Target listing slug (this OR categorySlug)."
    },
    "categorySlug": {
      "type": "string",
      "description": "Target category slug (this OR listingSlug)."
    },
    "company": {
      "type": "string",
      "description": "Optional company name."
    }
  },
  "required": [
    "name",
    "email",
    "message",
    "consent"
  ]
}

Single opt-in subscribe to the The Agents Index digest of new and freshly re-verified agents. Provide an email; returns { ok }. Every issue carries a one-click unsubscribe.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email to subscribe."
    },
    "source": {
      "type": "string",
      "description": "Optional: where the subscribe came from."
    }
  },
  "required": [
    "email"
  ]
}