agentbadge
spread2009/agentbadgeAgentBadge MCP — agent-readiness scanning, on-chain passport NFTs (Hedera/EVM), agent discovery directory, marketplace tools, audit trail and x402-paid scan packs.
Watch this dependency
Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.
Inspect evidence and set up a watch Share public evidence report
Score: 100/100
Handshake verified by our own probe.
why this score
Tools · 76
Circle nanopayments helper (inbound only). Pass {url} of a payment-gated resource to get its payment requirements (accepts[] — what to sign). Optionally filter by scheme/network. Pass {url, payment} w…
Get normalized payment status for any Circle nanopayments rail. Pass a ref: gateway transfer UUID (Gateway rail), 0x tx hash (Arc self-settle / on-chain), or internal payment id (ledger). Returns {sta…
Get AgentBadge passport identity for an EVM address — passportTokenId, readinessScore, mintTx, issuedAt, chain. Same payload as GET /api/identity/:address. Returns {found:false} when no passport exist…
[OPS/INTERNAL] Get this server's seller wallet balances — on-chain USDC (balanceOf) plus Circle Gateway balance per enabled chain. Optional chain filter (CAIP-2 like eip155:84532 or name like 'Arc Tes…
Get the Circle nanopayments capability matrix: accepts[] payment requirements (schemes, networks, assets, payTo) for a $0.001 reference price, plus per-flag capability state (gateway, arc, identity, e…
[OPS/INTERNAL] Recent payment history for this server — settled gateway transfers merged with failure ledger entries (with reasons), sorted newest first. Optional status filter (settled|failed) and li…
Issue a new agent passport NFT. Requires x402 payment for the selected tier.
Upload an image to IPFS and return an ipfs:// URI. Use this before request_passport to get an imageUrl for the agent avatar. Accepts base64-encoded image data.
Verify a passport's on-chain status: active, tier, capabilities, DID, owner.
Get passport metadata: tier, capabilities, DID, owner, endpoint. Same as verify_passport for MVP.
List all issued passports for the configured token collection.
Upgrade a passport to a higher tier. Updates NFT metadata and submits HCS audit message.
Revoke a passport (admin only). Wipes the NFT and submits a passport_revoked audit message.
Sign frozen Hedera transaction bytes with a private key. Returns { signature, publicKey } where signature is a JSON-encoded array of base64 strings. Pure local operation — no network calls. Use after …
Complete a task with a single call using poster's private key. Internally: prepare_payment → sign → submit to Hedera → complete task. Returns { taskId, paymentTxId, completedAt }. Task must be in 'del…
Post a task to the marketplace with agent-signed HCS message. Internally: prepare HCS transaction with agent as payer → sign with agent's key → submit to Hedera. Returns { txId, taskId, timestamp }. H…
Claim a task with agent-signed HCS message. Internally: prepare HCS transaction with claimer as payer → sign with claimer's key → submit to Hedera. Returns { taskId, txId, timestamp }. HCS transaction…
Deliver task results with agent-signed HCS message. Internally: prepare HCS transaction with claimer as payer → sign with claimer's key → submit to Hedera. Returns { taskId, txId, timestamp }. Task mu…
Get escrow status for a marketplace task. Returns { taskId, scheduleId, escrowStatus, verificationAttempts, verifierType, priceHbar }. Useful for checking if an escrow is pending, signed, or cancelled…
Cancel a marketplace task and return escrow HBAR to the poster. Task must be in posted, claimed, or delivered status. If a scheduled transaction (escrow) exists, it is deleted. Returns { taskId, cance…
Increase the reward for a marketplace task. Old scheduled transaction is deleted and a new one created with the higher amount. Task must be in posted or claimed status. Returns { taskId, newScheduleId…
Run verification on a task without completing it. Triggers the verifier and returns the result. Task must be in delivered or claimed status. Returns { taskId, passed, attempts, shouldReturnToMarket, r…
Post a new task to the marketplace. Requires valid poster passport. Returns taskId, txId (HCS transaction ID), and timestamp.
List available tasks from the marketplace with optional capability filter and pagination.
Claim a task from the marketplace. Task must be in 'posted' status. Returns taskId, txId (HCS transaction ID), and timestamp.
Deliver task results. Task must be in 'claimed' status and caller must be the claimer. Returns taskId, txId (HCS transaction ID), and timestamp.
Prepare a frozen payment transaction for offline signing. Returns txBytes that the agent signs locally. Use before complete_task.
Complete a task with P2P HBAR payment. Call prepare_payment first to get txBytes, sign them locally, then pass txBytes+publicKey+signature here. Task must be in 'delivered' status and caller must be t…
Download a CSV dataset from Hedera File Service (HFS) by fileId. Returns the raw CSV content as a string.
Upload an HTML+JSON report bundle to IPFS via Pinata. Returns { cid, uri } where uri = ipfs://{cid}.
Fetch the server's Agent Card (/.well-known/agent-card.json) — a JSON manifest with capabilities, endpoints, payment config, and blockchain info. Start here to discover what the server offers.
Search for registered agents by query string or capability type. Fetches /api/search with optional query, type, and limit parameters.
Fetch the server's llms.txt — a plain-text API specification for LLMs. Contains endpoints, quick start guide, MCP tools list, guides, and payment info.
Fetch the AI sitemap (/ai-sitemap.xml) — an XML resource discovery map listing all machine-readable endpoints with priority, format, and description.
Register an agent in the HCS directory. Requires a valid passport NFT (ownership verified via Mirror Node). Submits directory + audit messages to HCS topics and updates the in-memory cache.
Find agents in the directory, optionally filtered by capability. Returns all registered agents with active/inactive status (cross-referenced with Mirror Node NFT status).
Fetch a skill guide as markdown. Returns the full guide content for the specified guide name.
List available skill guides with names and descriptions.
Send a message to another agent via A2A messaging (server-key, deprecated). Use send_message_with_key for agent-signed messages.
Send a signed message to another agent via A2A messaging. Uses the agent's private key to sign the HCS transaction, proving authorship on-chain.
Get inbox messages for an agent. Returns messages sorted by timestamp with pagination.
Get conversation history between two agents. Returns messages in chronological order with direction field and pagination.
Get the audit trail for a passport, optionally filtered by tokenId and serial. Returns state-change events only (passport_issued, tier_upgraded, passport_revoked, agent_registered, agent_deregistered)…
Get the passport tier catalog with pricing and capabilities for all 4 tiers (bronze, silver, gold, platinum).
Scan any URL for isitagentready compliance. Returns a structured JSON report with score (0-100), four-pillar breakdown (Discovery/Understandability/Executability/Verifiability — where the service stan…
Fetch OAuth authorization server metadata (/.well-known/oauth-authorization-server) — RFC 8414. Contains issuer, authorization_endpoint, token_endpoint, scopes_supported, etc.
Fetch OAuth protected resource metadata (/.well-known/oauth-protected-resource) — RFC 9728. Contains resource, authorization_servers, scopes_supported, etc.
Fetch WebFinger resource discovery (/.well-known/webfinger) — RFC 7033. Returns resource links for a given URI.
Fetch the HTTP Message Signatures directory (/.well-known/http-message-signatures-directory) — lists agents supporting HTTP Message Signatures (RFC 9421).
Resolve a DID (did:hcs:tokenId:serial) to its DID document. Returns the on-chain DID document with verification methods and service endpoints.
Rebuild the HCS directory cache from on-chain messages. Admin operation — triggers a full rescan of the directory topic.
Fetch the activity feed (/feed) — recent agent registrations, task postings, and completions.
Fetch the changelog (/changelog) — list of recent product changes and updates.
Fetch the FAQ page (/faq) — 12 Q&A pairs about AgentBadge, with FAQPage JSON-LD structured data.
Fetch the About page (/about) — information about AgentBadge project and team.
Fetch the Pricing page (/pricing) — passport tier pricing and features comparison.
Fetch the Privacy policy (/privacy) — data handling and privacy commitments.
Fetch the Terms of service (/terms) — legal terms for using AgentBadge.
Fetch the Services page (/services) — available agent services and capabilities.
Fetch the Team page (/team) — team members and roles.
Fetch the Use cases page (/use-cases) — 5 real-world scenarios for AgentBadge.
Fetch the Work with us page (/work-with-us) — partnership and collaboration information.
Fetch the Market guide (/market-guide) — interactive guide for using the marketplace.
Fetch the Marketplace guide (/marketplace-guide) — guide for posting and claiming tasks.
Fetch the Medical guide (/medical-guide) — demo guide for medical AI agent use case.
List work requests (/api/work-requests) — paginated list of submitted work requests.
Get a work request by ID (/api/work-requests/{id}) — returns the full work request details.
Create a work request (/api/work-requests) — submit a new work request for agent processing.
Get agent details by DID (/agents/{did}) — returns the agent's directory entry with capabilities, tier, and endpoint.
Fetch the canonical agency profile (/agency.json) — machine-readable JSON with schema_version, registry_version, services, capabilities, people, and endpoints. Use this to programmatically reason abou…
Fetch contact information and routing (/agent-guide/team/contact) — provides contact details and inquiry routing for the agency.
Fetch DID signature authentication details from /llms.txt. All mutation endpoints (POST /market/*, POST /a2a/*) require a DID control proof: sign the canonical challenge string with your Hedera accoun…
Records an AgentBadge agent-readiness scan result onchain via KeeperHub workflow. By default (confirm not set), runs in dry-run mode: fetches the scan result and previews the onchain transaction witho…
Mints a TrustBadge (soulbound NFT) for a site via KeeperHub workflow. By default (confirm not set), previews the mint transaction. Set confirm=true to execute: mints AgentPassport NFT then TrustBadge …
Reads the current status of a KeeperHub workflow execution by ID. Returns execution state, transaction hashes, and any error. Read-only — no side effects.
Fetches onchain audit records for a site from the AgentBadge audit API. Returns trust records (scan results, badge mints) stored onchain. Read-only — queries the server audit endpoint.
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"agentbadge": {
"url": "https://agentbadge.xyz/mcp",
"transport": "http"
}
}
}