AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks

السجل الرسمي الذكاء الاصطناعي والوكلاء

Check an AI agent endpoint before you call it: read-only, no API key, returns a trustDecision.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http agenttrust-pre-invocation-ai-agent-trust 'https://getagenttrust.com/api/mcp/public'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "agenttrust-pre-invocation-ai-agent-trust": {
            "type": "http",
            "url": "https://getagenttrust.com/api/mcp/public"
        }
    }
}
Remote (streamable-http)
Claude Code
claude mcp add --transport http agenttrust-pre-invocation-ai-agent-trust 'https://getagenttrust.com/api/mcp' --header 'Authorization: <Bearer <API_KEY>. Required to call a tool (list_agents, get_agent, get_agent_health, send_heartbeat); tools/list and initialize work without one. Get a key by creating an account at https://getagenttrust.com/signup.>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "agenttrust-pre-invocation-ai-agent-trust": {
            "type": "http",
            "url": "https://getagenttrust.com/api/mcp",
            "headers": {
                "Authorization": "<Bearer <API_KEY>. Required to call a tool (list_agents, get_agent, get_agent_health, send_heartbeat); tools/list and initialize work without one. Get a key by creating an account at https://getagenttrust.com/signup.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AgentTrust — Pre-invocation Trust Check for AI Agent Endpoints
  2. Quick start — no account needed
  3. Public checks vs. agent management
  4. Documentation
  5. Developing this project

AgentTrust — Pre-invocation Trust Check for AI Agent Endpoints

Check an AI agent or MCP server endpoint before you call it. Given the exact endpoint URL, AgentTrust returns the reliability evidence it has already collected, endpoint-ownership verification, and a machine-readable trustDecision — without contacting the endpoint.

No AgentTrust account or API key required · Read-only · MCP and TypeScript SDK

AgentTrust is trust infrastructure for AI agents. It provides reliability monitoring, endpoint verification, and pre-invocation trust checks for MCP and A2A agents. An agent registers an identity, gets continuously health-monitored, optionally proves ownership of its endpoint, and accumulates a deterministic reliability score from that observed history. Any external AI agent or system can look up another agent by its invocation URL and get back a machine-readable trustDecision — a signal derived from AgentTrust's own observed and verified data, for the caller to weigh, never a certification or guarantee of safety — before deciding whether to interact with it.

Official MCP Registry identity: io.github.agenttrust-ai/agenttrust.

Quick start — no account needed

Every example below checks AgentTrust's own monitored test agent, https://agenttrust-umber.vercel.app/api/test-agent; swap in the URL you're about to call.

MCP

Add the public connector https://getagenttrust.com/api/mcp/public (Streamable HTTP, no authentication; one read-only tool, check_agent_trust). In Claude Code:

claude mcp add --transport http agenttrust https://getagenttrust.com/api/mcp/public

Claude Desktop, Cursor and a plain curl call: Connect an MCP client.

TypeScript SDK
npm install @getagenttrust/sdk
import { checkAgentTrust } from "@getagenttrust/sdk";

// AgentTrust's own test agent: a real, monitored endpoint you can check.
const result = await checkAgentTrust("https://agenttrust-umber.vercel.app/api/test-agent");

if (result.matched) {
  console.log(result.status, result.reliabilityScore, result.trustDecision);
  // e.g. "healthy" 100 { recommended: true, confidence: "high", reasons: [] }
} else {
  // AgentTrust has no data for this endpoint (yet). An unmatched result never
  // carries a score; result.observation may say it was queued for a lookup.
  console.log("Unknown endpoint", result.observation?.status);
}

Policies (assertTrusted), errors and options: SDK README · npm.

In the browser

Check the test agent on getagenttrust.com.

Public checks vs. agent management

Public trust checksAgent management
ForChecking any endpoint before you call itRegistering and monitoring your own agents; full agent records
Account / API keyNot neededAccount and API key (Authorization: Bearer <API_KEY>)
InterfacesMCP check_agent_trust at /api/mcp/public; @getagenttrust/sdkREST /api/v1/*; MCP server /api/mcp (list_agents, get_agent, get_agent_health, send_heartbeat)

To register an agent: sign up, create a key under Dashboard → API keys, then follow Getting started (REST).

Documentation

You don't need this repository to use AgentTrust:

  • /docs — full REST, MCP and SDK reference.
  • /llms.txt — the same reference as one plain-text file, for an LLM's context.

Developing this project

This is a Next.js (App Router) + Drizzle + Supabase app, deployed on Vercel.

npm install
npm run dev

Open http://localhost:3000. You'll need a .env.local — see .env.example for the required variables (Supabase credentials, database connection strings, and the server-only secrets described inline).

Useful scripts:

npm run test        # vitest — full suite runs against an embedded pglite DB, no live database needed
npm run typecheck    # tsc --noEmit
npm run lint         # eslint
npm run db:generate   # generate a new Drizzle migration from schema changes (offline)
npm run db:migrate    # apply pending migrations to the database in DIRECT_URL

الأسئلة الشائعة

ما هو AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks؟

Check an AI agent endpoint before you call it: read-only, no API key, returns a trustDecision.

كيف أثبّت AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agenttrust-pre-invocation-ai-agent-trust 'https://getagenttrust.com/api/mcp/public'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AgentTrust — Pre-Invocation AI Agent Trust & Reliability Checks؟

ينشره agenttrust-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.