# Ethos

> Ethos is a free MCP server for finance and payments. Read-only lookups of Ethos credibility scores and profiles for wallets and X accounts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://developers.ethos.network/api-documentation/mcp
- **Repository:** https://github.com/trust-ethos/api-docs
- **MCP Registry name:** network.ethos/api
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

Ethos is a reputation network, and this endpoint serves five of its lookups to agents without a key or payment. The tools are ethos_score, ethos_user_by_x, ethos_user_by_address, ethos_search_users and ethos_xp. People are named by a userkey such as address:0x..., service:x.com:username:..., or a Discord or Telegram id.

Scores run from 0 to 2800. The server's initialize answer tells the agent how to read them: below 800 is untrusted, 800 to 1199 questionable, 1200 to 1399 neutral, and 1400 and up increasingly reputable. The docs add that scores reflect peer judgement and can be gamed at the margins, so they are a signal rather than a verdict.

The server is stateless, returns JSON, and passes through the free API's rate limits; refused lookups come back as tool errors. It does not write anything, so reviews, vouches and XP tips need the full API with a key.

## Features

- **Credibility score:** Returns a 0 to 2800 score and level for a userkey.
- **X and wallet lookup:** Finds the profile behind an X account or EVM address.
- **Profile search:** Searches by name, handle or address fragment.
- **Total XP:** Returns XP across all seasons.
- **Stateless and keyless:** No sign-in, no session id, no state kept between calls.

## Good for

- Check a wallet's reputation before interacting with it
- Look up the Ethos profile behind an X handle
- Search for a profile by address fragment
- Let an agent weigh counterparties by score band

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http api https://developers.ethos.network/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://developers.ethos.network/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "api": {
      "url": "https://developers.ethos.network/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "api": {
      "type": "http",
      "url": "https://developers.ethos.network/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "api": {
      "serverUrl": "https://developers.ethos.network/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "api": {
      "type": "http",
      "url": "https://developers.ethos.network/mcp"
    }
  }
}
```

## Tools

- `ethos_score`: Credibility score and level for a userkey.
- `ethos_user_by_x`: The Ethos profile behind an X handle or account id, with linked accounts.
- `ethos_user_by_address`: The Ethos profile holding an EVM wallet address.
- `ethos_search_users`: Profiles matching a name, handle or address fragment.
- `ethos_xp`: Total XP across all seasons for a userkey.

## FAQ

### Do I need an API key?

No. The endpoint is free, read-only and unauthenticated.

### What score range does it use?

0 to 2800, with levels such as untrusted, questionable and neutral.

### Can it post reviews or vouches?

No, only reads. Writes need the full API with a key.

### How many tools are there?

Five.

### Is Ethos free?

Yes. Ethos is free to use.

### How do I add Ethos to Claude Code?

Run this command in your terminal: claude mcp add --transport http api https://developers.ethos.network/mcp

### What are the best alternatives to Ethos?

The closest alternatives to Ethos are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/ethos
