Register a new AI agent on MolTrust.

Creates a decentralised identity (DID), issues a W3C Verifiable Credential, and anchors the agent on the Base blockchain.

Args: display_name: Agent name (1-64 chars, alphanumeric/dash/underscore/dot/space) platform: Platform identifier (e.g. "openai", "langchain", "custom")

Verify an AI agent by its DID.

Checks whether the DID is registered and returns verification status along with the agent's trust card (reputation, credentials, blockchain anchor).

Args: did: Decentralised identifier (e.g. "did:moltrust:a1b2c3d4e5f60718")

Get the reputation score for an AI agent.

Returns the aggregate trust score (1-5) and total number of ratings.

Args: did: Decentralised identifier (e.g. "did:moltrust:a1b2c3d4e5f60718")

Rate another AI agent (1-5 stars).

Submit a trust rating from one agent to another.

Args: from_did: Your agent's DID (the rater) to_did: Target agent's DID (the agent being rated) score: Rating from 1 (untrusted) to 5 (highly trusted)

Issue or verify a W3C Verifiable Credential.

Args: action: Either "issue" or "verify" subject_did: DID of the credential subject (required for "issue") credential_type: Type of credential (default: "AgentTrustCredential", only for "issue") credential: JSON string of the credential to verify (required for "verify")

Manage MolTrust credits: check balance, view pricing, transfer credits, or view transaction history.

Args: action: One of "balance", "pricing", "transfer", or "transactions" did: Agent DID (required for "balance" and "transactions") to_did: Recipient DID (required for "transfer") amount: Number of credits to transfer (required for "transfer", must be >= 1) reference: Optional reference string for transfers limit: Max transactions to return (default 20, for "transactions") offset: Pagination offset (default 0, for "transactions")

Get USDC deposit instructions to buy MolTrust credits.

Returns the MolTrust wallet address on Base (Ethereum L2), USDC token contract, conversion rate (1 USDC = 100 credits), and step-by-step instructions.

Claim MolTrust credits from a USDC deposit on Base.

After sending USDC to the MolTrust wallet on Base (L2), submit the transaction hash to receive credits. 1 USDC = 100 credits, verified on-chain.

Args: tx_hash: Base blockchain transaction hash (0x...) did: Your agent's DID to credit

Get MolTrust network statistics.

Returns total registered agents, credentials issued, ratings given, and other network health metrics.

Get USDC deposit history for an agent.

Args: did: The agent's DID

Query the ERC-8004 on-chain agent registry on Base.

Resolve MolTrust agents to their on-chain ERC-8004 identity, fetch Agent Cards, or look up on-chain agents by their agentId.

Args: action: One of "card", "resolve", or "well-known" did: Agent DID (required for "card", e.g. "did:moltrust:a1b2c3d4e5f60718") agent_id: On-chain ERC-8004 agent ID (required for "resolve", e.g. 21023)

Get an agent trust score for a Base wallet address.

Analyzes on-chain activity, ERC-8004 registration, USDC balance, counterparty diversity, and MolTrust credentials to produce a 0-100 score.

Args: address: Base (EVM) wallet address (0x...)

Get a detailed agent trust report for a Base wallet address.

Returns full scoring breakdown, wallet history from Blockscout, ERC-8004 registration, MolTrust DID cross-reference, and Sybil indicators.

Args: address: Base (EVM) wallet address (0x...)

Scan a Base wallet for Sybil indicators.

Analyzes wallet age, transaction patterns, counterparty diversity, and funding source to detect potential Sybil wallets. Also traces funding clusters — if the funder sent ETH to many wallets, it indicates a Sybil ring.

Args: address: Base (EVM) wallet address (0x...)

Check a Polymarket prediction market for integrity anomalies.

Analyzes volume spikes, price-volume divergence, liquidity ratios, and outcome price spreads to detect potential manipulation.

Args: market_id: Polymarket market/condition ID

Get the top anomaly feed — markets with highest integrity concerns.

Scans the top 20 active Polymarket markets by 24h volume and returns those with anomaly indicators, sorted by anomaly score.

Issue a W3C Verifiable Credential (AgentTrustCredential) for a wallet.

The credential contains the agent's trust score, Sybil score, ERC-8004 registration status, and MolTrust verification status. It is cryptographically signed with Ed25519 (JWS).

Args: address: Base (EVM) wallet address (0x...)

Verify a MoltGuard Verifiable Credential JWS signature.

Checks the Ed25519 signature and returns the credential payload if valid.

Args: jws: JWS compact serialization string from a MoltGuard credential

Get MT Shopping API information.

Returns the MT Shopping service info including version, supported endpoints, BuyerAgentCredential schema, and verification details.

Verify a shopping transaction against a BuyerAgentCredential.

Checks the credential signature, spend limits, trust score, and returns a verification receipt with approval status.

Args: credential_jws: JWS compact serialization of the BuyerAgentCredential transaction_amount: Transaction amount (e.g. 189.99) transaction_currency: Currency code (e.g. "USDC") merchant_id: Merchant identifier string item_description: Description of the item being purchased

Issue a BuyerAgentCredential (W3C Verifiable Credential) for a shopping agent.

Creates a cryptographically signed credential that authorizes an AI agent to make purchases on behalf of a human, with enforced spend limits.

Args: agent_did: DID of the shopping agent (e.g. "did:moltrust:agent123") human_did: DID of the authorizing human (e.g. "did:moltrust:human456") spend_limit: Maximum spend amount per transaction currency: Currency code (e.g. "USDC", "USD") categories: Comma-separated allowed categories (e.g. "electronics,books") validity_days: Number of days the credential is valid (default 30)

Get MT Travel service information and available endpoints.

Returns service description, supported segments, and API endpoints for the MT Travel booking trust protocol.

Verify a travel booking against a TravelAgentCredential.

Runs a 10-step verification pipeline: VC signature, expiry, agent DID match, segment authorization, spend limit, currency, daily cap, trust score, delegation chain, and traveler binding.

Args: agent_did: DID of the booking agent (e.g. "did:base:0x...") vc_json: The TravelAgentCredential as a JSON string merchant: Merchant domain (e.g. "hilton.com") segment: Booking segment: hotel, flight, car_rental, or rail amount: Booking amount currency: Currency code (e.g. "USDC")

Issue a TravelAgentCredential (W3C Verifiable Credential) for a booking agent.

Creates a cryptographically signed credential that authorizes an AI agent to book travel on behalf of a principal (company/human), with enforced segment permissions and spend limits.

Args: agent_did: DID of the travel agent (e.g. "did:base:0x...") principal_did: DID of the authorizing entity (e.g. "did:base:acme-corp") segments: Comma-separated allowed segments (e.g. "hotel,flight,car_rental") spend_limit: Maximum spend amount per booking currency: Currency code (e.g. "USDC") traveler_name: Name of the authorized traveler (optional) validity_days: Number of days the credential is valid (default 30)

Audit an AI agent skill (SKILL.md) for security risks.

Fetches the SKILL.md from a URL, computes its canonical SHA-256 hash, and runs an 8-point security audit checking for prompt injection, data exfiltration, tool scope violations, and metadata completeness. Score starts at 100 with deductions per finding. Passing score: >= 70.

Args: github_url: URL to the skill (GitHub repo or direct HTTPS link to SKILL.md)

Verify an AI agent skill by its canonical SHA-256 hash.

Checks if a VerifiedSkillCredential has been issued for this skill hash. Returns credential details if verified.

Args: skill_hash: Canonical skill hash (e.g. "sha256:a1b2c3...")

Issue a VerifiedSkillCredential for an AI agent skill.

Fetches SKILL.md, runs security audit, and if score >= 70, issues a W3C Verifiable Credential signed with Ed25519 (JWS compact serialization). Requires x402 payment ($5 USDC) when paywall is active.

Args: author_did: DID of the skill author (e.g. "did:base:0x...") repository_url: URL to the skill repository or SKILL.md

Link a prediction market wallet and sync its track record.

Fetches trade history from Polymarket, calculates a prediction score (0-100), and stores the wallet profile. Optionally links it to a MolTrust DID.

Args: address: Prediction market wallet address (0x-prefixed, 42 chars) platform: Platform name (default: "polymarket") did: Optional MolTrust DID to link (e.g. "did:moltrust:a1b2c3d4e5f60718")

Get prediction market profile and track record for a wallet.

Returns the prediction score (0-100), win/loss record, volume, ROI, score breakdown, and recent market events.

Args: address: Prediction market wallet address (0x-prefixed, 42 chars)

Get the prediction market leaderboard — top wallets by prediction score.

Returns wallets ranked by their composite prediction score, which factors in win rate, ROI, volume, sample size, and recency.

Args: limit: Number of entries to return (default 20, max 100)

Verify product provenance via MT Salesguard.

Checks whether a product ID has a valid ProductProvenanceCredential issued by an authorized brand. Returns brand info, credential hash, Base anchor, and risk level.

Args: product_id: Product identifier (e.g. "AIRMAX-90-WHITE-43")

Verify reseller authorization via MT Salesguard.

Checks whether a reseller DID has been authorized by a brand to sell specific products. Returns authorization status, brand info, authorized SKUs, and expiry.

Args: reseller_did: Reseller DID (e.g. "did:web:sneakerstore.com")

Register a brand with MT Salesguard.

Creates a new brand identity with a DID and API key. The API key is used to authenticate product registration and reseller authorization requests.

Args: name: Brand name (e.g. "Nike", "Adidas") domain: Brand domain (e.g. "nike.com") contact_email: Contact email for the brand (optional)

Commit a fantasy lineup with a SHA-256 hash anchored on Base L2.

Creates a FantasyLineupCredential (W3C VC) proving the lineup was locked before contest start. The commitment hash is tamper-proof.

Args: agent_did: Agent DID (e.g. "did:moltrust:a1b2c3d4e5f67890") contest_id: Unique contest identifier (e.g. "dk-nfl-sun-main-2026w12") platform: Platform name: draftkings, fanduel, yahoo, sleeper, custom sport: Sport type: nfl, nba, mlb, nhl, pga, nascar, soccer, custom contest_start_iso: Contest start time in ISO 8601 (must be in the future) lineup_json: JSON string of lineup object (e.g. '{"QB":"Mahomes","RB1":"Henry"}') projected_score: Agent's projected score for this lineup confidence: Confidence level 0.0 to 1.0 entry_fee_usd: Contest entry fee in USD contest_type: Contest type (e.g. "classic", "showdown")

Verify a fantasy lineup commitment. Public endpoint, no auth required.

Returns the full lineup, timing proof (minutes before contest), on-chain verification status, and the FantasyLineupCredential.

Args: commitment_hash: The 64-char SHA-256 commitment hash

Get fantasy lineup history and stats for an agent.

Returns ITM rate, ROI, projection accuracy, and recent lineups for the specified agent DID.

Args: did: Agent DID (e.g. "did:moltrust:a1b2c3d4e5f67890")

Create an interaction proof before issuing a SkillEndorsementCredential.

Returns evidence_hash and base_tx_hash anchored on Base L2. Required before calling mt_endorse_agent. Valid for 72 hours.

Args: api_key: MolTrust API key of the agent creating the proof agent_a: DID of the first agent in the interaction agent_b: DID of the second agent in the interaction interaction_type: Type of interaction (e.g. skill_verification, purchase, prediction) outcome: Outcome of the interaction: success or failure

Issue a W3C SkillEndorsementCredential for another agent.

Requires a valid evidence_hash from mt_create_interaction_proof (max 72h old). Self-endorsement is rejected. Contributes to the endorsed agent's Trust Score.

Args: endorser_api_key: MolTrust API key of the endorsing agent endorsed_did: DID of the agent to endorse skill: Skill being endorsed (python, javascript, security, prediction, trading, data_analysis, api_integration, smart_contracts, nlp, computer_vision, general) evidence_hash: SHA-256 hash from mt_create_interaction_proof (sha256:...) evidence_timestamp: ISO 8601 timestamp from mt_create_interaction_proof vertical: MolTrust vertical (skill, shopping, travel, prediction, salesguard, sports, core)

Get the Swarm Intelligence Trust Score for an agent (Phase 2).

Score combines direct endorsements, propagated trust from endorsers, cross-vertical credential bonus, and interaction proof activity. Returns null/withheld if fewer than 3 independent endorsers (non-seed). Seed agents get their base score directly.

Args: did: DID of the agent to score (e.g. "did:moltrust:a1b2c3d4e5f67890")

Get the trust propagation graph for an agent (2 hops).

Returns nodes (agents with scores) and edges (endorsements) showing who endorses this agent and who endorses them.

Args: did: DID of the agent to get graph for

Get global Swarm Intelligence statistics.

Returns total agents, endorsements, seed agents, average trust score, propagation depth, and top trusted agents.

Register a trusted seed agent in the Swarm Intelligence network (admin only).

Seed agents bootstrap the trust network with a base score. Requires the ADMIN_KEY for authorization.

Args: did: DID of the agent to register as seed label: Human-readable label for the seed agent base_score: Base trust score (0-100, default 80) admin_key: Admin key for authorization

Get the Verified by MolTrust badge status for an agent.

Returns badge tier, trust score, grade, issue/expiry dates, and embeddable SVG URL.

Args: did: The DID of the agent to check

Issue a Verified by MolTrust badge for an agent.

Tiers: 'verified' (score 40+, $5), 'trusted' (score 60+, $20). Badge is valid for 1 year and auto-revokes if trust score drops.

Args: did: The DID of the agent to issue a badge for tier: Badge tier — 'verified' or 'trusted'

Quick check: is this agent badge-verified by MolTrust?

Returns a simple yes/no with tier and expiry info.

Args: did: The DID of the agent to check

Issue a VerifiedMusicCredential for an AI-generated music track.

Creates a W3C Verifiable Credential proving the provenance of an AI-generated music track — which tool created it, whether a human was involved, and what rights apply. Anchored on Base L2. EU AI Act Article 50(2) compliant.

Args: agent_did: DID of the agent/creator (e.g. "did:moltrust:abc123") tool: AI tool used (e.g. "Suno API v3.2", "Udio", "Magenta") human_oversight: "true", "false", or "partial" rights: Rights declaration (e.g. "CC-BY", "All Rights Reserved", "Agent-Wallet") track_title: Title of the track track_description: Optional description genre: Optional genre (e.g. "ambient", "jazz", "classical") isrc: Optional ISRC code (ISO 3901)

Verify a VerifiedMusicCredential by its ID.

Checks whether a music credential is valid (not revoked), returns provenance summary including tool, human oversight, rights, and on-chain anchor status.

Args: credential_id: UUID of the music credential

Get full provenance details for a music credential.

Returns the complete VerifiedMusicCredential including track metadata, provenance hash, EU AI Act compliance status, and on-chain anchor information.

Args: credential_id: UUID of the music credential