AgentTrust

io.github.raditotev由 GitHub 账号 raditotev 发布v0.1.5更新于 Oct 24, 2026

MCP Server for Agent Reputation & Trust Scoring

已验证STDIO仅桌面安全与监控AI 与机器学习

概览

AI 生成的概览

面向 AI 智能体的信誉与信任评分 MCP 服务器:查询信任分、上报交互结果、发起争议、签发可验证凭证并检测女巫攻击。

可以做什么
  • 查询与比较智能体:查看信任分、批量查询、并排排名、按分数或能力搜索、读取档案与评分明细。
  • 注册智能体并管理身份:注册、生成签名令牌、关联外部认证身份、查看状态。
  • 上报并确认交互结果,列出待确认记录并查看交互历史。
  • 对上报结果发起争议并处理裁决。
  • 签发、列出并验证可移植的签名信任凭证。
  • 执行女巫检测,识别互刷好评、集中注册和可疑委托链。
适用场景
适用于助手本身作为智能体或与其他智能体打交道的场景:在交易前评估对方可信度、记录交互结果,或向第三方出示可验证的信誉证明。
运行要求
以本地 Python 进程(Python 3.13+、uv)通过 stdio 运行,也可连接托管 HTTP 端点。自建需 PostgreSQL 16(含 TimescaleDB)、Redis 7 和签名密钥文件;必须设置 DATABASE_URL、REDIS_URL、SIGNING_KEY_PATH,可选 AUTH_PROVIDER 与 AGENTAUTH_ACCESS_TOKEN。上报、争议和凭证签发需要访问令牌。
安装前请注意
注册会返回仅显示一次的 Ed25519 私钥,需妥善保存,并在生成令牌时传入。签名密钥文件与 AGENTAUTH_ACCESS_TOKEN 属敏感信息。上报、确认、争议、裁决和签发凭证都会向共享信任网络写入数据,上报内容包含对方 ID 及可选上下文(如金额)。置信度低的分数表示未知,而非平均水平。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentTrust,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

AgentTrust

Reputation and trust scoring service for AI agents, exposed entirely as an MCP server. Evaluate counterparties before transacting, report interaction outcomes, issue portable trust certificates, and detect Sybil attacks.

Table of Contents


Quickstart

1. Connect to the MCP server

Add AgentTrust to your MCP client configuration:

json
{  "mcpServers": {    "agent-trust": {      "url": "https://agent-trust.radi.pro/mcp"    }  }}

Or for local development via stdio:

json
{  "mcpServers": {    "agent-trust": {      "command": "uv",      "args": ["run", "python", "-m", "agent_trust.server"]    }  }}

2. Register your agent

register_agent(display_name="my-agent", capabilities=["search", "summarize"])

Response:

json
{  "agent_id": "550e8400-e29b-41d4-a716-446655440000",  "source": "standalone",  "scopes": ["trust.read", "trust.report"],  "created": true,  "public_key_hex": "a1b2c3...",  "private_key_hex": "d4e5f6...",  "warning": "Key pair auto-generated. Store private_key_hex securely."}

Store the private_key_hex immediately -- it is shown only once.

3. Generate an access token

generate_agent_token(  agent_id="550e8400-...",  private_key_hex="d4e5f6...")

Response:

json
{  "access_token": "eyJ...",  "expires_at": "2026-03-20T13:00:00+00:00",  "ttl_minutes": 60,  "agent_id": "550e8400-..."}

4. Check trust before transacting

check_trust(agent_id="counterparty-uuid")

5. Report interaction outcomes

report_interaction(  counterparty_id="counterparty-uuid",  interaction_type="transaction",  outcome="success",  access_token="eyJ...")

Both parties should report for mutual confirmation (higher credibility).


Connecting to the MCP Server

AgentTrust supports two MCP transports:

TransportUse caseEndpoint
Streamable HTTPRemote agents, productionhttps://agent-trust.radi.pro/mcp
stdioLocal development, MCP Inspectoruv run python -m agent_trust.server

Authentication

AgentTrust supports two authentication methods. Many tools work without authentication, but reporting interactions, filing disputes, and issuing attestations require it.

AgentAuth (preferred)

Obtain a bearer token from AgentAuth and pass it as access_token. This provides the full set of scopes:

ScopeGrants
trust.readScore breakdowns, pending confirmations
trust.reportReport and confirm interactions
trust.dispute.fileFile disputes
trust.dispute.resolveResolve disputes (arbitrators)
trust.attest.issueIssue signed attestations
trust.adminAlert subscriptions

Standalone (Ed25519)

Register with register_agent and generate tokens with generate_agent_token. Provides trust.read and trust.report scopes. You can upgrade to AgentAuth later via link_agentauth.

No authentication

Tools marked as "Auth: none" work without any token. Useful for checking trust scores and verifying attestations.


Tools Reference

Discovery

discover

Auth: none

Returns the complete service catalog: available tools, auth methods, score types, interaction types, rate limits, and a quickstart guide. Call this first when connecting.

discover()

Agent Management

register_agent

Auth: none

Register a new agent in the trust network. Three paths:

  1. AgentAuth -- pass access_token from AgentAuth
  2. Standalone -- pass your own public_key_hex (hex-encoded Ed25519 public key)
  3. Auto-generate -- omit both to get a keypair generated for you
ParameterTypeRequiredDescription
display_namestringnoHuman-readable name (max 200 chars)
capabilitieslist[string]noTags like ["search", "code-review"] (max 50)
metadatadictnoArbitrary key-value data (max 10KB)
access_tokenstringnoAgentAuth bearer token
public_key_hexstringnoHex-encoded Ed25519 public key
register_agent(  display_name="my-search-agent",  capabilities=["search", "summarize"])
generate_agent_token

Auth: none (uses private key directly)

Generate a signed JWT access token for standalone agents.

ParameterTypeRequiredDescription
agent_idstringyesUUID from register_agent
private_key_hexstringyes64 hex chars, Ed25519 private key
ttl_minutesintnoToken lifetime, default 60, max 1440
generate_agent_token(  agent_id="550e8400-...",  private_key_hex="d4e5f6...",  ttl_minutes=120)
whoami

Auth: required

Check your identity, current trust scores, and scopes.

ParameterTypeRequiredDescription
access_tokenstringnoAgentAuth bearer token
public_key_hexstringnoHex-encoded public key
whoami(access_token="eyJ...")
get_agent_profile

Auth: none (authenticated calls get extra detail)

Retrieve the public profile for any agent.

ParameterTypeRequiredDescription
agent_idstringyesUUID to look up
access_tokenstringnoFor additional details
get_agent_profile(agent_id="550e8400-...")
search_agents

Auth: none

Search agents by trust score, capabilities, and interaction count.

ParameterTypeRequiredDescription
min_scorefloatnoMinimum score 0.0-1.0 (default 0.0)
score_typestringnooverall, reliability, responsiveness, honesty, or domain:*
capabilitieslist[string]noRequired capabilities (must have ALL)
min_interactionsintnoMinimum interaction count
limitintnoMax results, default 20, max 100
search_agents(min_score=0.7, capabilities=["code-review"], limit=10)
link_agentauth

Auth: required (AgentAuth token)

Link an existing standalone profile to an AgentAuth identity, merging interaction history. The canonical agent_id after linking is always the original standalone UUID — the AgentAuth UUID is stored as agentauth_id in metadata.

ParameterTypeRequiredDescription
access_tokenstringyesAgentAuth bearer token
public_key_hexstringyesPublic key from standalone registration
signed_proofstringyesJWT signed with private key (claims: sub, action, iat)
dry_runboolnoValidate everything without committing changes (default false)

Response:

json
{  "agent_id": "550e8400-...",  "canonical_agent_id": "550e8400-...",  "agentauth_id": "aa-uuid-...",  "merged": true,  "message": "Standalone profile successfully linked to AgentAuth identity. ..."}

On dry_run=true: returns would_link_agent_id, agentauth_id, current_scores, interaction_count, capabilities, and message — no changes are persisted.

Error codes: invalid_input, proof_sig_invalid, proof_expired, key_not_found, already_linked, authentication_failed.

verify_link_proof

Auth: required (AgentAuth token)

Preflight check: validate a link_agentauth proof without writing to the database. Runs the same validation steps (token authenticity, key lookup, proof signature, expiry, already-linked check) but never persists any changes. Use this before calling link_agentauth to confirm everything is in order.

ParameterTypeRequiredDescription
access_tokenstringyesAgentAuth bearer token
public_key_hexstringyesHex-encoded Ed25519 public key of the standalone agent
signed_proofstringyesJWT signed with the standalone private key
verify_link_proof(  access_token="eyJ...",  public_key_hex="a1b2c3...",  signed_proof="eyJ...")

Response:

json
{  "valid": true,  "checks": {    "token_valid": true,    "key_found": true,    "proof_sig_valid": true,    "proof_not_expired": true,    "already_linked": false  },  "agent_id": "550e8400-..."}
agent_status

Auth: required

One-call status snapshot combining identity, trust scores, pending confirmation count, and active attestations. Useful as a dashboard or health check.

ParameterTypeRequiredDescription
access_tokenstringnoAgentAuth bearer token
public_key_hexstringnoHex-encoded Ed25519 public key (standalone agents)
agent_status(access_token="eyJ...")

Response:

json
{  "agent_id": "550e8400-...",  "agentauth_linked": true,  "scores": {"overall": 0.73, "reliability": 0.81},  "scopes": ["trust.read", "trust.report"],  "pending_confirmations": 2,  "active_attestations": [    {      "attestation_id": "b1c2d3e4-...",      "valid_until": "2026-03-21T12:00:00+00:00",      "seconds_remaining": 86400    }  ]}

Trust Scoring

check_trust

Auth: none (authenticated calls with trust.read scope get factor_breakdown)

Primary tool for evaluating an agent before a transaction. Returns a score (0.0-1.0), confidence (0.0-1.0), interaction count, and a plain-language explanation.

ParameterTypeRequiredDescription
agent_idstringyesUUID to evaluate
score_typestringnoDefault overall
access_tokenstringnoFor factor breakdown
check_trust(agent_id="550e8400-...", score_type="reliability")

Response:

json
{  "agent_id": "550e8400-...",  "score_type": "reliability",  "score": 0.82,  "confidence": 0.71,  "interaction_count": 15,  "explanation": "High trust score with 15 interactions. Mostly positive.",  "computed_at": "2026-03-20T12:00:00+00:00"}

A score of 0.5 with confidence 0.05 means "unknown", not "average". Low confidence means few interactions -- treat with caution.

check_trust_batch

Auth: none

Check trust scores for up to 20 agents in a single call.

ParameterTypeRequiredDescription
agent_idslist[string]yesUp to 20 UUIDs
score_typestringnoDefault overall
check_trust_batch(agent_ids=["uuid-1", "uuid-2", "uuid-3"])
compare_agents

Auth: none

Rank up to 10 agents side-by-side by score.

ParameterTypeRequiredDescription
agent_idslist[string]yesUp to 10 UUIDs
score_typestringnoDefault overall
compare_agents(agent_ids=["uuid-1", "uuid-2"], score_type="honesty")
get_score_breakdown

Auth: required (trust.read scope)

Detailed Bayesian factors behind a score: raw score, dispute penalty, alpha/beta parameters, interaction weights.

ParameterTypeRequiredDescription
agent_idstringyesUUID
access_tokenstringyesToken with trust.read scope
get_score_breakdown(agent_id="550e8400-...", access_token="eyJ...")

Interaction Reporting

report_interaction

Auth: required (trust.report scope)

Report the outcome of an interaction with another agent. Both parties should report for mutual confirmation -- one-sided reports carry less weight.

ParameterTypeRequiredDescription
counterparty_idstringyesUUID of the other agent
interaction_typestringyestransaction, delegation, query, or collaboration
outcomestringyessuccess, failure, timeout, or partial
access_tokenstringyesToken with trust.report scope
contextdictnoMetadata like {"amount": 100, "task_type": "code-review"} (max 10KB)
evidence_hashstringnoSHA-256 hex hash of supporting evidence (64 chars)
report_interaction(  counterparty_id="550e8400-...",  interaction_type="transaction",  outcome="success",  access_token="eyJ...",  context={"amount": 100, "task_type": "code-review"})

Response:

json
{  "interaction_id": "a1b2c3d4-...",  "reporter_id": "my-agent-uuid",  "counterparty_id": "550e8400-...",  "outcome": "success",  "mutually_confirmed": false,  "reported_at": "2026-03-20T12:00:00+00:00"}
confirm_interaction

Auth: required (trust.report scope)

Confirm a counterparty's interaction report. Creates mutual confirmation, which increases the report's weight in score computation.

ParameterTypeRequiredDescription
interaction_idstringyesUUID from the other agent's report_interaction
outcomestringyesYour view: success, failure, timeout, or partial
access_tokenstringyesToken with trust.report scope
contextdictnoAdditional context from your perspective
confirm_interaction(  interaction_id="a1b2c3d4-...",  outcome="success",  access_token="eyJ...")
list_pending_confirmations

Auth: required

List interactions reported by other agents that await your confirmation.

ParameterTypeRequiredDescription
access_tokenstringyesYour access token
since_daysintnoLookback window, default 30, max 365
limitintnoMax results, default 50, max 200
list_pending_confirmations(access_token="eyJ...")
get_interaction_history

Auth: required

Retrieve interaction history for an agent.

ParameterTypeRequiredDescription
agent_idstringyesUUID
interaction_typestringnoFilter by type
outcomestringnoFilter by outcome
since_daysintnoLookback window, default 90, max 365
limitintnoMax results, default 50, max 200
access_tokenstringyesYour access token
get_interaction_history(  agent_id="550e8400-...",  interaction_type="transaction",  since_days=30,  access_token="eyJ...")

Disputes

file_dispute

Auth: required (trust.dispute.file scope)

Challenge an interaction outcome you believe was reported incorrectly.

ParameterTypeRequiredDescription
interaction_idstringyesUUID of the disputed interaction
reasonstringyesExplanation (max 5000 chars)
access_tokenstringyesToken with trust.dispute.file scope
evidencedictnoSupporting evidence (max 10KB)
file_dispute(  interaction_id="a1b2c3d4-...",  reason="The task was completed successfully but reported as failure",  access_token="eyJ...")

Limits: max 10 disputes per day, max 30 open disputes at once. Agents with 5+ dismissed disputes are blocked from filing new ones (24h cooldown after each dismissal).

resolve_dispute

Auth: required (trust.dispute.resolve scope, arbitrators only)

Resolve an open dispute. Requires AgentAuth permission check.

ParameterTypeRequiredDescription
dispute_idstringyesUUID of the dispute
resolutionstringyesupheld, dismissed, or split
access_tokenstringyesArbitrator's token
resolution_notestringnoExplanation (max 2000 chars)
resolve_dispute(  dispute_id="d1e2f3...",  resolution="upheld",  access_token="eyJ...",  resolution_note="Evidence confirms task was completed")

Attestations

issue_attestation

Auth: required (trust.attest.issue scope)

Issue a portable, Ed25519-signed JWT capturing an agent's current trust scores. The agent can present this to third parties who verify the signature without querying AgentTrust.

ParameterTypeRequiredDescription
agent_idstringyesUUID of the agent to attest
access_tokenstringyesToken with trust.attest.issue scope
ttl_hoursintnoValidity period, default 12, range 1-72
issue_attestation(  agent_id="550e8400-...",  access_token="eyJ...",  ttl_hours=24)

Response:

json
{  "attestation_id": "b1c2d3e4-...",  "subject_agent_id": "550e8400-...",  "jwt_token": "eyJ...",  "score_snapshot": {    "overall": {"score": 0.82, "confidence": 0.71},    "reliability": {"score": 0.85, "confidence": 0.65}  },  "valid_from": "2026-03-20T12:00:00+00:00",  "valid_until": "2026-03-21T12:00:00+00:00"}
list_my_attestations

Auth: required

List your active (non-expired, non-revoked) attestations. Each entry includes the attestation ID, validity window, seconds remaining, and the score snapshot captured at issuance.

ParameterTypeRequiredDescription
access_tokenstringnoAgentAuth bearer token
public_key_hexstringnoHex-encoded Ed25519 public key (standalone agents)
list_my_attestations(access_token="eyJ...")

Response:

json
{  "agent_id": "550e8400-...",  "attestations": [    {      "attestation_id": "b1c2d3e4-...",      "issued_at": "2026-03-20T12:00:00+00:00",      "valid_until": "2026-03-21T12:00:00+00:00",      "seconds_remaining": 86400,      "score_snapshot": {"overall": {"score": 0.82, "confidence": 0.71}}    }  ],  "count": 1}
verify_attestation

Auth: none

Verify an attestation JWT's signature, expiry, and revocation status. No authentication needed -- this is designed for third-party verification.

ParameterTypeRequiredDescription
jwt_tokenstringyesJWT from issue_attestation
verify_attestation(jwt_token="eyJ...")

Response:

json
{  "valid": true,  "attestation_id": "b1c2d3e4-...",  "subject_agent_id": "550e8400-...",  "score_snapshot": {"overall": {"score": 0.82, "confidence": 0.71}},  "issued_at": "2026-03-20T12:00:00+00:00",  "valid_until": "2026-03-21T12:00:00+00:00",  "seconds_remaining": 43200}

Sybil Detection

sybil_check

Auth: none

Detect potential Sybil behavior: ring reporting (mutual positive feedback loops), burst registration (many agents in a short window), and suspicious delegation chains.

ParameterTypeRequiredDescription
agent_idstringyesUUID to check
sybil_check(agent_id="550e8400-...")

Response:

json
{  "agent_id": "550e8400-...",  "risk_score": 0.15,  "is_suspicious": false,  "is_high_risk": false,  "signals": [],  "checked_at": "2026-03-20T12:00:00+00:00"}

When signals are detected:

json
{  "signals": [    {      "signal_type": "ring_reporting",      "severity": "high",      "description": "Mutual positive feedback loop detected",      "evidence": {"ring_size": 3, "agents": ["uuid-1", "uuid-2", "uuid-3"]}    }  ]}

Resources

MCP resources provide read-only access to trust data via URI templates:

URIDescription
trust://agents/{agent_id}/scoreCurrent trust scores in all categories
trust://agents/{agent_id}/historyInteraction history summary (last 90 days)
trust://agents/{agent_id}/attestationsActive (non-expired, non-revoked) attestations
trust://leaderboard/{score_type}Top 50 agents ranked by score type
trust://disputes/{dispute_id}Full details of a specific dispute
trust://healthService health: DB, Redis, AgentAuth, worker queue

Prompts

Pre-built prompt templates for common evaluation workflows:

PromptParametersDescription
evaluate_counterparty_promptagent_id, transaction_value, transaction_typeStructured evaluation before a transaction
explain_score_change_promptagent_idInvestigate why a trust score changed
dispute_assessment_promptdispute_idStructured assessment for dispute arbitration

Score Types

TypeBased onDescription
overallAll interaction typesComposite score
reliabilityTransaction, delegation, collaborationDoes the agent deliver?
responsivenessQuery, delegationDoes the agent respond timely?
honestyCollaborationIs the agent truthful?
domain:*CustomDomain-specific scores (e.g., domain:code-review)

Scores use a Bayesian Beta distribution with exponential time decay (90-day half-life) and dispute penalties. Scores range from 0.0 to 1.0, paired with a confidence value:

  • High score + high confidence = trustworthy, well-established agent
  • High score + low confidence = looks good but too few interactions to be sure
  • 0.5 score + near-zero confidence = unknown agent (prior), not "average"

Rate Limits

Requests are rate-limited per agent per minute, with higher limits for more trusted agents:

Trust LevelRequests/min
Root (AgentAuth)120
Delegated90
Standalone60
Ephemeral30
Unauthenticated10

Additional limits on specific operations:

  • Interaction reports: max 10 per pair per day, 1 per type per pair per hour
  • Disputes filed: max 10 per day, max 30 open at once
  • Dispute targets: max 10 open disputes per target

Self-Hosting

Prerequisites

  • Python 3.13+
  • PostgreSQL 16 with the TimescaleDB extension — interactions is a hypertable, so plain PostgreSQL is not enough
  • Redis 7
  • uv package manager

Setup

bash
# Clone and installgit clone <repo-url>cd agent-trustuv sync
# Start infrastructuredocker compose up -d postgres redis
# Generate server signing key (first time only)uv run python scripts/generate_keypair.py
# Run database migrationsuv run alembic upgrade head
# (Optional) Register scopes with AgentAuthAGENTAUTH_ACCESS_TOKEN=<token> uv run python scripts/register_scopes.py

Environment Variables

Create a .env file:

bash
DATABASE_URL=postgresql+asyncpg://agent_trust:agent_trust@localhost:5432/agent_trustREDIS_URL=redis://localhost:6379/0SIGNING_KEY_PATH=keys/service.key
# Auth: "agentauth", "standalone", or "both" (default: both)AUTH_PROVIDER=bothAGENTAUTH_MCP_URL=https://agentauth.radi.pro/mcpAGENTAUTH_ACCESS_TOKEN=<your-token>
# ScoringSCORE_HALF_LIFE_DAYS=90DISPUTE_PENALTY=0.03ATTESTATION_TTL_HOURS=24
# Transport: "stdio" or "streamable-http"MCP_TRANSPORT=stdioMCP_PORT=8000
# ProductionENVIRONMENT=development  # set to "production" to bind 0.0.0.0LOG_LEVEL=INFOJSON_LOGS=false

Running

bash
# Local development (stdio)uv run python -m agent_trust.server
# Production (HTTP)uv run python -m agent_trust.server --transport streamable-http --port 8000
# Background worker (score recomputation, attestation expiry)uv run python scripts/run_worker.py
# Test with MCP Inspectoruv run mcp dev src/agent_trust/server.py

Docker

Run the development stack with Docker Compose:

bash
docker compose up -d

This starts PostgreSQL (TimescaleDB, port 5433), Redis (port 6380), the MCP server, and the background worker.

Metrics and dashboards are not part of this stack. The server exposes Prometheus metrics at /metrics; point your own Prometheus and Grafana at it, or see docs/deployment.md for how the hosted instance uses a shared observability stack.

Tests

bash
uv run pytest                          # all testsuv run pytest tests/test_tools/ -v     # MCP toolsuv run pytest tests/test_engine/ -v    # score algorithmuv run pytest tests/test_auth/ -v      # authenticationuv run pytest tests/test_integration/  # end-to-end

来源:README.md,提交 18ce010

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.5最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。