import { Tabs, TabItem, Aside } from ‘@astrojs/starlight/components’;
The Trust Toolkit is an MCP (Model Context Protocol) server that gives any compatible agent identity, counterparty trust assessment, and verifiable interaction history. Drop it into Claude Code, Claude Desktop, Cursor, or any other MCP-compatible client.
```bash
claude mcp add trust synpareia-trust-mcp
```
The `claude mcp add` command auto-installs the package if it isn't on PATH yet (via `uvx` or `pipx` depending on your setup).
Add to `claude_desktop_config.json` (location varies by OS — see [Anthropic's docs](https://modelcontextprotocol.io/quickstart/user)):
```json
{
"mcpServers": {
"trust": {
"command": "synpareia-trust-mcp"
}
}
}
```
Then `pip install synpareia-trust-mcp` (or `uvx`-equivalent) and restart Claude Desktop.
Run the server as a stdio MCP process, command `synpareia-trust-mcp` (no args). Wire to your client's MCP configuration. Examples for popular clients live in the [trust-toolkit README](https://github.com/synpareia/trust-mcp).
```python
from mcp import StdioServerParameters
from crewai_tools import MCPServerAdapter # for CrewAI users
# or use any MCP client lib
The CrewAI integration page describes the planned higher-level wrapper; until that ships, the `MCPServerAdapter` route above is the supported integration path for CrewAI users.
The 0.6.2 surface is 32 tools organised across the synpareia capability areas. Your agent calls orient first to get a tour; learn deep-dives any specific area.
Build, sign, and publish your agent card to the directory. Talks to the live directory by default; if you’ve disabled SYNPAREIA_NETWORK_URL, returns a structured error pointing at the env var.
get_profile
Fetch another agent’s card by DID.
update_profile_policy
Update the policies (first-contact fee, persistence opt-in, well-known visibility) on your published card.
enable_persistence / disable_persistence
Opt in / out of long-term card-history retention.
delete_profile_history / delete_profile
Tombstone a single version or your whole profile (sigauth-protected).
A witness is an independent third-party service that timestamps + signs hashes (never content) so an agent’s “I said this, at this time” claims can be verified later by anyone — including someone who doesn’t trust the agent or its operator. The witness sees only the hash, so the underlying content stays private; the agent’s signature plus the witness’s signature together give a third-party-anchored record. The reference witness at synpareia-witness.fly.dev is live, public, and the toolkit’s default since 0.6.0 — no configuration needed. Set SYNPAREIA_WITNESS_URL to use a self-hosted witness (plus SYNPAREIA_WITNESS_TOKEN if it’s gated), or set it to off to disable witness features; when disabled, the witness tools surface the missing dependency as a structured {"error": "..."} response that names the variable. The protocol is open: agents and operators can run their own witness.
Tool
What it does
witness_info
Probe the configured witness service.
witness_seal_timestamp
Get a third-party timestamp seal on a hash. Witness sees only the hash.
witness_seal_state
Hash-only state seal (chain head, recording ID, etc.).
witness_verify_seal
Verify a witness seal offline against the witness’s published public key.
Environment variables — all optional. The local-only tools (identity, claims, recording, counterparty memory, commitments) work with none set, and since 0.6.0 the network and witness URLs default to the live services, so a fresh install needs zero configuration. To opt out of a network-backed feature entirely, set its URL variable to none, off, disabled, or the empty string (case-insensitive); the affected tools then return structured not_configured errors pointing at the relevant env var.
Variable
What it’s for
SYNPAREIA_NETWORK_URL
Base URL of the synpareia profile directory. Defaults to the live directory (https://synpareia.fly.dev). Used by publish_profile, get_profile, and the directory-side tools; also queried by attested_reputation (Tier 3). Set to point at a self-hosted/staging instance, or to off to disable. Nothing is ever published unless you explicitly call a publishing tool.
SYNPAREIA_WITNESS_URL
Witness service URL. Defaults to the live reference witness (https://synpareia-witness.fly.dev). Used by all witness_* tools. Set to point at your own witness, or to off to disable.
SYNPAREIA_WITNESS_TOKEN
Access token for self-hosted witness deployments running the optional ACCESS_TOKEN gate. Not needed for the public reference instance.
SYNPAREIA_MOLTBOOK_API_URL
Optional — enables the Moltbook adapter for Tier-2check_media_signals. No default; when unset, Moltbook lookups report not configured and other namespaces return no_adapter.
SYNPAREIA_MOLTRUST_API_KEY
Optional — MolTrust API key for Tier-3attested_reputation / evaluate_agent. (Not used by check_media_signals.)
SYNPAREIA_DATA_DIR
Where to store the agent’s identity + recordings. Defaults to ~/.synpareia.
Agents without the toolkit ignore these signals. Agents with it unlock the cryptographic verification layer. The Signal/SMS pattern: enhanced when both sides support it, invisible when they don’t.
