Ethos MCP

Is this wallet, X account or person trustworthy? Ethos credibility score (0 to 2800) and level, from untrusted to renowned, built from peer reviews, ETH-backed vouches, slashes and linked on-chain and social history. Use it before trading with, following, quoting or paying an unknown counterparty, to rank accounts by reputation, or to flag likely scams and bots. Takes an EVM address, X handle or account id, Discord or Telegram id, or Ethos profile id. Free, no payment or key; the same answer as the free Ethos API. Example input: {"userkey":"service:x.com:username:ethos_network"}. Example output: {"score":2441,"level":"revered"}

{
  "type": "object",
  "required": [
    "userkey"
  ],
  "properties": {
    "userkey": {
      "type": "string",
      "description": "An Ethos userkey: address:0x… (EVM address), profileId:<n>, service:x.com:<X account id>, service:x.com:username:<X handle>, service:discord:<id> or service:telegram:<id>."
    }
  }
}

{
  "title": "Credibility score for a userkey",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Who is behind an X (Twitter) handle, and can they be trusted? The Ethos profile for a handle or numeric account id: display name, credibility score and status, every wallet address and social account linked to the same person, XP, influence factor, and how many positive, neutral and negative reviews and vouches they have received. Use it to vet an account before engaging, resolve a handle to its wallets, or enrich a mention with reputation. Free, no payment or key; the same answer as the free Ethos API. Example input: {"handle":"ethos_network"}. Example output: {"id":32936,"profileId":1,"displayName":"Ethos","username":"ethos_network","avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":2441,"status":"ACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}

{
  "type": "object",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "description": "X handle without the @, or the numeric X account id."
    }
  }
}

{
  "title": "Ethos user by X (Twitter) handle or account id",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Who owns this wallet, and what is their reputation? The Ethos profile holding an EVM address: display name, X handle and other linked accounts, credibility score and status, XP, influence factor, and review and vouch counts. Use it to attach a name and trust level to a counterparty address before a trade, transfer, airdrop or allowlist decision, or to screen addresses in a transaction for known bad actors. Free, no payment or key; the same answer as the free Ethos API. Example input: {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}. Example output: {"id":32936,"profileId":1,"displayName":"vitalik.eth","username":null,"avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":1311,"status":"INACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "EVM address, 0x-prefixed."
    }
  }
}

{
  "title": "Ethos user by EVM address",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

Find a person or project on Ethos when you only have a name, a partial handle or part of an address. Returns matching profiles with credibility score, status, linked wallets and social accounts, paginated. The starting point when a user asks about someone by name: search, pick the match, then score or profile it by userkey. Also useful for disambiguating impersonators from the real account. Free, no payment or key; the same answer as the free Ethos API. Example input: {"query":"vitalik","limit":"5"}. Example output: {"values":[{"id":32936,"profileId":1,"displayName":"Ethos","username":"ethos_network","avatarUrl":"https://pbs.twimg.com/profile_images/2074951227599646720/85k3GJ-s.jpg","score":2441,"status":"ACTIVE","userkeys":["profileId:1","service:x.com:1234567890","address:0x1234…"],"xpTotal":4076702,"influenceFactor":276,"stats":{"review":{"received":{"positive":120,"neutral":3,"negative":2}},"vouch":{"received":{"count":40}}}}],"total":1,"limit":5,"offset":0}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page, default 10."
    },
    "query": {
      "type": "string",
      "description": "Name, handle or address fragment to search for."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Results to skip, for paging."
    }
  }
}

{
  "title": "Search Ethos users",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}

How active and invested is this person in the Ethos reputation network? Total XP earned across all seasons for a userkey (address, X handle or id, Discord or Telegram id, or profile id). XP accrues from reviews, vouches, invitations and other contributions, so it separates long-standing, engaged members from fresh or dormant accounts. Use it alongside the credibility score to weigh how much history stands behind a reputation. Free, no payment or key; the same answer as the free Ethos API. Example input: {"userkey":"profileId:1"}. Example output: 4076702

{
  "type": "object",
  "required": [
    "userkey"
  ],
  "properties": {
    "userkey": {
      "type": "string",
      "description": "An Ethos userkey: address:0x… (EVM address), profileId:<n>, service:x.com:<X account id>, service:x.com:username:<X handle>, service:discord:<id> or service:telegram:<id>."
    }
  }
}

{
  "title": "Total XP for a userkey",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}