Maiat Trust Oracle

by JhiNResH

194 downloads
Not rated
GitHub

Description

<p align="center"> <img src="https://raw.githubusercontent.com/JhiNResH/maiat-protocol/master/apps/web/public/maiat-logo.jpg" width="120" alt="Maiat" /> </p> <h1 align="center">Maiat Protocol</h1> <p align="center"> <strong>The trust layer for agentic commerce.</strong><br/>…

About

<p align="center"> <img src="https://raw.githubusercontent.com/JhiNResH/maiat-protocol/master/apps/web/public/maiat-logo.jpg" width="120" alt="Maiat" /> </p> <h1 align="center">Maiat Protocol</h1> <p align="center"> <strong>The trust layer for agentic commerce.</strong><br/> Trust oracle for AI agents and tokens —…

Details

Author
JhiNResH
Downloads
194
Categories
Database

- Trust scores for agents and tokens
- Honeypot detection for tokens
- Trust‑gated Uniswap swaps via quote API
- Community reviews with Scarab token cost
- Trust Passport for wallet addresses
- Integration with MCP‑compatible AIs

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Maiat Trust Oracle
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The MCP server is available as the @jhinresh/mcp-server npm package. Developers can install it and connect any MCP‑compatible AI (Claude, GPT, etc.) to the Maiat API endpoints listed in the README (e.g., /api/v1/agent/:address, /api/v1/token/:address).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "maiat trust oracle": {
            "maiat": {
                "url": "https://app.maiat.io/api/mcp"
            }
        }
    }
}

McpServers

{
    "maiat": {
        "url": "https://app.maiat.io/api/mcp"
    }
}

<p align="center">
Maiat
</p>

<h1 align="center">Maiat Protocol</h1>

<p align="center">
<strong>The trust layer for agentic commerce.</strong><br/>
Trust oracle for AI agents and tokens — powered by on-chain behavioral data, community reviews, and EAS attestations.
</p>

<p align="center">
<a href="https://app.maiat.io">Live App</a> ·
<a href="https://app.maiat.io/docs">API Docs</a> ·
<a href="https://app.virtuals.io/acp">ACP Agent #18281</a>
</p>

---

Monorepo Structure

maiat-protocol/
├── apps/
│   └── web/                    # Next.js dashboard + API (app.maiat.io)
│       ├── src/
│       │   ├── app/            # Pages + API routes (/api/v1/*)
│       │   ├── components/     # React components
│       │   ├── hooks/          # React hooks
│       │   └── lib/            # Utilities (scoring, eas, uniswap, etc.)
│       ├── public/             # Static assets
│       ├── prisma/             # Database schema + migrations
│       ├── package.json        # Web app dependencies
│       └── tsconfig.json       # TypeScript config
├── contracts/                  # Solidity smart contracts (Foundry)
│   ├── src/                    # Contract source
│   ├── test/                   # Forge tests
│   └── foundry.toml            # Foundry config
├── packages/                   # SDKs and plugins
│   ├── sdk/                    # @jhinresh/maiat-sdk
│   ├── guard/                  # @jhinresh/viem-guard
│   ├── mcp-server/             # @jhinresh/mcp-server
│   ├── elizaos-plugin/         # ElizaOS integration
│   ├── agentkit-plugin/        # Coinbase AgentKit integration
│   ├── game-plugin/            # GAME SDK plugin
│   ├── virtuals-plugin/        # Virtuals GAME SDK plugin
│   ├── maiat-evaluator-node/   # @jhinresh/maiat-evaluator
│   ├── maiat-evaluator-py/     # Python evaluator
│   └── wadjet/                 # Rug prediction engine
├── docs/                       # Documentation
├── scripts/                    # Utility scripts (indexer, etc.)
├── tests/                      # Root-level integration tests
├── package.json                # Workspace config
├── tsconfig.json               # Root TypeScript config
└── LICENSE

---

Quick Start

git clone https://github.com/JhiNResH/maiat-protocol.git
cd maiat-protocol
npm install

Run the web app

npm run dev

Or run from the apps/web directory

cd apps/web npm run dev

---

Smart Contracts (Base Mainnet)

| Contract | Address |
| ------------------------ | -------------------------------------------- |
| MaiatOracle | 0xc6cf2d59ff2e4ee64bbfceaad8dcb9aa3f13c6da |
| MaiatReceiptResolver | 0xda696009655825124bcbfdd5755c0657d6d841c0 |
| TrustGateHook | 0xf980Ad83bCbF2115598f5F555B29752F00b8daFf |

EAS Schema UID: 0x24b0db687434f15057bef6011b95f1324f2c38af06d0e636aea1c58bf346d802

---

API Endpoints

| Route | Method | Description |
|---|---|---|
| /api/v1/agent/:address | GET | Agent trust score |
| /api/v1/agent/:address/deep | GET | Deep analysis |
| /api/v1/agents | GET | Browse all 2,292+ agents |
| /api/v1/token/:address | GET | Token honeypot check |
| /api/v1/swap/quote | POST | Trust-gated Uniswap quote |
| /api/v1/review | POST | Submit review (costs 2 Scarab) |
| /api/v1/wallet/:address/passport | GET | Trust Passport |
| /api/v1/scarab | GET | Scarab balance |
| /api/v1/markets | GET | Prediction markets |

---

Packages

| Package | Description |
|---------|-------------|
| @jhinresh/maiat-sdk | Core SDK — trust scores, token safety, swap verification |
| @jhinresh/viem-guard | Viem middleware — auto-checks trust before transactions |
| @jhinresh/mcp-server | MCP Server for Claude, GPT, and MCP-compatible AIs |
| @jhinresh/elizaos-plugin | ElizaOS plugin — trust-gate actions and evaluators |
| @jhinresh/agentkit-plugin | Coinbase AgentKit plugin |
| @jhinresh/game-maiat-plugin | GAME SDK plugin |
| @jhinresh/virtuals-plugin | Virtuals GAME SDK plugin |
| @jhinresh/maiat-evaluator | Drop-in ACP evaluator |

---

Contributing

Pull requests are welcome. For major changes, open an issue first.

We use Conventional Commits and squash-merge all PRs.

---

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.