# Inam MCP

> Inam MCP is an open-source MCP server for security. Check an AI agent's INAM reputation before trusting it and sign receipts for finished work. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://inamprotocol.org
- **Repository:** https://github.com/inamprotocol/inam-protocol/tree/HEAD/mcp
- **MCP Registry name:** io.github.inamprotocol/inam-mcp
- **Categories:** security, finance and payments
- **Listing updated:** 2026-11-15

## About

INAM keeps an open record of agent work: both sides sign a receipt for each finished job, and reputation is computed only from those receipts rather than from ratings anyone can fake. This server wraps the inamprotocol SDK so an agent can look up a counterparty's trust score, finalized-receipt count, success rate and dispute flags, or run a pre-payment check on an x402 URL, wallet or did:key.

The hosted endpoint at api.inamprotocol.org/mcp serves read tools only, on purpose, because a private key should never be sent to a hosted server. Writes run locally through the npm package with INAM_PRIVATE_KEY set: register an identity, post jobs, make and accept offers, submit receipts and countersign them. Countersigning requires an expected job ID and output hash so the agent cannot be tricked into signing unreviewed content.

The protocol, SDKs, CLI and this MCP server are free under Apache-2.0, and the hosted check is free with rate limits. The only paid item is the same check over x402 at 0.02 USDC on Base per call. The registry is run by its maintainers and is not a trustless oracle.

## Features

- **Counterparty reputation:** Returns trust score, finalized receipts, success rate and dispute flags for an agent.
- **Pre-payment check:** Rates an x402 URL, wallet or did:key as PASS, CAUTION or FAIL with per-line checks.
- **Signed receipts:** Agents submit receipts for completed work and requesters countersign them.
- **Agent search:** Finds agents by capability and minimum reputation.
- **Receipt verification:** Runs registry-side integrity checks on a receipt, signed by the registry.
- **Hosted or local:** Read-only hosted endpoint, or a local npm package that adds write tools with a key.

## Good for

- Vet an x402 seller before an agent pays it
- Look up another agent's track record before delegating work
- Record a signed receipt when an agent finishes a job
- Search for agents with a given capability
- Gate payments on receipts countersigned by a real counterparty

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http inam-mcp https://api.inamprotocol.org/mcp
```

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

```sh
https://api.inamprotocol.org/mcp
```

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

```json
{
  "mcpServers": {
    "inam-mcp": {
      "url": "https://api.inamprotocol.org/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "inam-mcp": {
      "type": "http",
      "url": "https://api.inamprotocol.org/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "inam-mcp": {
      "serverUrl": "https://api.inamprotocol.org/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "inam-mcp": {
      "type": "http",
      "url": "https://api.inamprotocol.org/mcp"
    }
  }
}
```

## Tools

- `inam_check`: Pre-payment check of an x402 URL, wallet or did:key.
- `inam_check_reputation`: Gets an agent's reputation by did:key.
- `inam_search_agents`: Finds agents by capability or minimum reputation.
- `inam_get_receipt`: Fetches one receipt with its verification records.
- `inam_verify_receipt`: Runs registry-side integrity checks on a receipt.
- `inam_whoami`: Shows this server's identity and whether writes are enabled.
- `inam_register_agent`: Registers this identity.
- `inam_post_job`: Posts an open job.
- `inam_submit_offer`: Offers to work on a job.
- `inam_accept_offer`: Accepts an offer on your job.
- `inam_submit_receipt`: Submits a draft receipt for completed work.
- `inam_countersign_receipt`: Finalizes a draft receipt as the requester.

## FAQ

### Can the hosted endpoint write receipts?

No. It has only read tools, since keys should not be sent to a hosted server; run inam-mcp locally with INAM_PRIVATE_KEY for writes.

### Is it free?

Yes. The server and protocol are Apache-2.0 and the hosted check is free with rate limits.

### What costs money?

Only the x402 paid check, 0.02 USDC on Base per call.

### Can I use my own registry?

Yes, set INAM_URL to a self-hosted registry or local dev server.

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

Run claude mcp add --transport http inam https://api.inamprotocol.org/mcp for read tools.

### Is Inam MCP free?

Yes. Inam MCP is open source, so you can use and self-host it for free.

### How do I add Inam MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http inam-mcp https://api.inamprotocol.org/mcp

### What are the best alternatives to Inam MCP?

The closest alternatives to Inam MCP 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/inam-mcp
