← Back to Agent Chain

SDK + MCP + CLI

The JavaScript AgentGuardian SDK, agc CLI and @agent-chain/mcp-server expose the Agent Chain API. The MCP server currently advertises 120 tools. This reference is generated from the source interfaces.

Install from a source checkout

From the AgentChain repository root, install the local packages below. Package names are @agent-chain/sdk, @agent-chain/cli and @agent-chain/mcp-server; registry publication is separate from source availability.

npm install ./sdk
npm install -g ./cli
npm install --prefix mcp

There is no Python SDK in this repository. The JavaScript package exports CommonJS and supports named ESM imports; it does not ship TypeScript declarations.

SDK quick start

import { AgentGuardian, AgentGuardianError } from '@agent-chain/sdk';

const ac = new AgentGuardian({
  apiKey: process.env.AGENT_CHAIN_API_KEY,
  baseUrl: process.env.AGENT_CHAIN_BASE_URL || 'https://api.agent-chain.io'
});
const identity = await ac.verify('did:agent:example');
const scan = await ac.scanResponse('Hello world');
const trust = await ac.checkTrust('did:agent:example');
const threat = await ac.checkThreat('did:agent:example');
// Registration is ac.registerAgent({ name: 'my-bot', capabilities: [] }).

apiKey is required. The SDK default baseUrl is https://api.agent-chain.io, with a 10000 ms timeout. cache defaults to true and cacheTtl to 60000 ms. Environment variables are passed explicitly in the example; the SDK constructor does not read them automatically.

All 125 public SDK methods

ac.verify(...)
ac.registerAgent(...)
ac.listAgents(...)
ac.getAgent(...)
ac.issueCredential(...)
ac.scanResponse(...)
ac.getScanHistory(...)
ac.getScanStats(...)
ac.createScanRule(...)
ac.checkTrust(...)
ac.attest(...)
ac.recordInteraction(...)
ac.reportAnomaly(...)
ac.checkThreat(...)
ac.submitThreatIndicator(...)
ac.getIntelSummary(...)
ac.listFrameworks(...)
ac.getFramework(...)
ac.runAudit(...)
ac.getAuditHistory(...)
ac.getAuditRun(...)
ac.submitAuditEvidence(...)
ac.createAuditSchedule(...)
ac.listAuditSchedules(...)
ac.deleteAuditSchedule(...)
ac.listPersonas(...)
ac.listTTPs(...)
ac.deployHoneypot(...)
ac.listHoneypots(...)
ac.getHoneypot(...)
ac.updateHoneypot(...)
ac.captureAttack(...)
ac.getCaptures(...)
ac.listAttackerProfiles(...)
ac.getAttackerProfile(...)
ac.getShadowStats(...)
ac.listFirewallModes(...)
ac.createFirewallConfig(...)
ac.listFirewallConfigs(...)
ac.getFirewallConfig(...)
ac.updateFirewallConfig(...)
ac.deleteFirewallConfig(...)
ac.createFirewallRule(...)
ac.listFirewallRules(...)
ac.updateFirewallRule(...)
ac.deleteFirewallRule(...)
ac.evaluateTraffic(...)
ac.getFirewallEvents(...)
ac.getFirewallEvent(...)
ac.listQuarantined(...)
ac.reviewQuarantine(...)
ac.getFirewallStats(...)
ac.listSensors(...)
ac.ingestSighting(...)
ac.listTrackedAgents(...)
ac.getTrackedAgent(...)
ac.updateTrackedAgent(...)
ac.getTrackedAgentSightings(...)
ac.addCorrelation(...)
ac.getTrackedAgentCorrelations(...)
ac.getTrackerAlerts(...)
ac.acknowledgeTrackerAlert(...)
ac.getTrackerGraph(...)
ac.executeAutoResponse(...)
ac.getTrackerStats(...)
ac.getChainInfo(...)
ac.listBlocks(...)
ac.getBlock(...)
ac.getTransaction(...)
ac.verifyTransaction(...)
ac.listNFTs(...)
ac.getNFT(...)
ac.getNFTByAgent(...)
ac.transferNFT(...)
ac.updateNFT(...)
ac.burnNFT(...)
ac.getNFTEvents(...)
ac.recordChainEvent(...)
ac.getChainHealth(...)
ac.verifyChain(...)
ac.listWallets(...)
ac.getWallet(...)
ac.fundWallet(...)
ac.makePayment(...)
ac.refundPayment(...)
ac.openChannel(...)
ac.listChannels(...)
ac.getChannel(...)
ac.channelPayment(...)
ac.closeChannel(...)
ac.getPaymentHistory(...)
ac.getUsageMeters(...)
ac.meterApiCall(...)
ac.getPaymentStats(...)
ac.listTiers(...)
ac.getTier(...)
ac.applyCustomization(...)
ac.listCustomizations(...)
ac.getAgentCustomization(...)
ac.getCustomization(...)
ac.updateCustomization(...)
ac.importNFT(...)
ac.revokeCustomization(...)
ac.getSupportedChains(...)
ac.listSupportedWallets(...)
ac.getWalletsForChain(...)
ac.connectWallet(...)
ac.listConnectedWallets(...)
ac.disconnectWallet(...)
ac.createCryptoPayment(...)
ac.listCryptoPayments(...)
ac.getCryptoPayment(...)
ac.confirmCryptoPayment(...)
ac.createStripePayment(...)
ac.listStripePayments(...)
ac.getStripePayment(...)
ac.attachStripeSession(...)
ac.confirmStripePayment(...)
ac.getTreasury(...)
ac.getMarketplaceStats(...)
ac.submitReview(...)
ac.getListingReviews(...)
ac.searchListings(...)
ac.fullCheck(...)
ac.clearCache(...)

CLI

Set AGENT_CHAIN_API_KEY in your shell and set AGENT_CHAIN_BASE_URL=https://api.agent-chain.io to connect to the public API. The binary is agc; credentials are environment variables, with no config set command.

agc --help
agc verify did:agent:example
agc scan "Hello world"
agc trust did:agent:example
agc full-check did:agent:example
agc chain blocks --help

All 90 CLI commands

agc verify <did> — Verify an AI agent identity by DID
agc register-agent — Register a new AI agent
agc list-agents — List your registered agents
agc get-agent <agentId> — Get agent details by ID
agc issue-credential <agentId> — Issue a verifiable credential for an agent
agc scan <text> — Scan agent output for manipulation, injection, exfiltration
agc scan-history — Get scan history
agc scan-stats — Get scanning statistics
agc create-scan-rule — Create a custom scanning rule
agc trust <did> — Check trust score for an agent
agc attest — Submit a peer attestation
agc record-interaction — Record an agent interaction outcome
agc report-anomaly — Report an anomaly for an agent
agc threat <did> — Check agent against threat intelligence database
agc submit-indicator — Submit a threat indicator
agc intel-summary — Get global threat intelligence summary
agc full-check <did> — Full agent check — identity + trust + threat in parallel
agc audit frameworks — List supported compliance frameworks
agc audit framework <id> — Get framework details (EU_AI_ACT, NIST_AI_RMF, ISO_42001, SOC2, OWASP_LLM_TOP10)
agc audit run — Run a compliance audit
agc audit history — Get audit history
agc audit get <runId> — Get audit run details
agc audit evidence <runId> — Submit audit evidence
agc audit schedule — Create an audit schedule
agc audit schedules — List audit schedules
agc shadow personas — List available honeypot personas
agc shadow ttps — List known TTP patterns
agc shadow deploy — Deploy a honeypot agent
agc shadow list — List your honeypots
agc shadow get <id> — Get honeypot details
agc shadow captures <honeypotId> — List attack captures for a honeypot
agc shadow attackers — List attacker profiles
agc shadow stats — Shadow network statistics
agc firewall modes — List firewall modes
agc firewall create — Create a firewall config
agc firewall list — List firewall configs
agc firewall get <configId> — Get firewall config with rules
agc firewall delete <configId> — Delete a firewall config
agc firewall add-rule <configId> — Add a firewall rule
agc firewall rules <configId> — List rules for a config
agc firewall evaluate <configId> — Evaluate agent traffic against rules
agc firewall events — List firewall events
agc firewall quarantine — List quarantined payloads
agc firewall stats — Firewall statistics
agc tracker sensors — List sensor types
agc tracker ingest — Ingest an agent sighting
agc tracker list — List tracked agents
agc tracker get <agentId> — Get tracked agent profile
agc tracker sightings <agentId> — Get sightings for an agent
agc tracker correlate — Link two tracked agents
agc tracker alerts — Get alert feed
agc tracker ack <alertId> — Acknowledge an alert
agc tracker graph — Get relationship graph data
agc tracker auto-respond <agentId> — Auto-respond to high-risk agent
agc tracker stats — Tracker dashboard stats
agc chain info — Chain overview
agc chain blocks — List blocks
agc chain block <height> — Get block by height
agc chain tx <txId> — Get transaction
agc chain verify-tx <txId> — Verify transaction signature
agc chain nfts — List NFTs
agc chain nft <id> — Get NFT details
agc chain transfer-nft <nftId> <toAddress> — Transfer NFT
agc chain burn-nft <nftId> — Burn an NFT
agc chain health — Chain health check
agc chain verify-chain — Full chain integrity verification
agc payments wallets — List wallets
agc payments wallet <id> — Get wallet detail
agc payments fund <walletId> <amount> — Fund wallet with credits
agc payments send — Agent-to-agent payment
agc payments refund <paymentId> — Refund a payment
agc payments open-channel — Open a payment channel
agc payments channels <agentId> — List channels for agent
agc payments channel <id> — Get channel detail
agc payments close-channel <channelId> — Close and settle channel
agc payments history <agentId> — Transaction history
agc payments meters <agentId> — API usage meters
agc payments stats — Payment statistics
agc marketplace tiers — List customization tiers
agc marketplace tier <id> — Get tier detail
agc marketplace customize — Apply customization to an agent
agc marketplace chains — List supported blockchain chains
agc marketplace wallets — List supported wallet connectors
agc marketplace connect — Connect a crypto wallet
agc marketplace connections — List connected wallets
agc marketplace pay-crypto — Create crypto payment
agc marketplace pay-stripe — Create Stripe payment
agc marketplace treasury — Platform treasury addresses
agc marketplace stats — Marketplace statistics
agc health — Agent Chain platform health check

MCP configuration

Install dependencies in mcp/, then configure your MCP client with the absolute source path and your API key. The package is @agent-chain/mcp-server. Set AGENT_CHAIN_BASE_URL=https://api.agent-chain.io as shown below.

{
  "mcpServers": {
    "agent-chain": {
      "command": "node",
      "args": [
        "/absolute/path/to/AgentChain/mcp/src/index.js"
      ],
      "env": {
        "AGENT_CHAIN_API_KEY": "ac_live_your_key",
        "AGENT_CHAIN_BASE_URL": "https://api.agent-chain.io"
      }
    }
  }
}

Read-only and destructive-action annotations are hints for MCP clients. Server authentication, permissions, payment checks and feature gates still apply. A listed client method or tool does not enable an unavailable backend. Native crypto checkout remains disabled.

All 120 MCP tool names

ac1_verify — Verify an AI agent identity and credentials by DID (mutation)
ac1_register_agent — Register a new AI agent with name, description, and capabilities (mutation)
ac1_list_agents — List your registered AI agents (read only)
ac1_get_agent — Get full agent details including DID document (read only)
ac1_issue_credential — Issue a verifiable credential (VC-JWT) for an agent (mutation)
ac2_scan_response — Scan an agent response for manipulation, injection, exfiltration, jailbreak (mutation)
ac2_scan_history — Get scan history with pagination (read only)
ac2_scan_stats — Get scanning statistics (total, safe, flagged, by risk) (read only)
ac2_create_scan_rule — Create a custom scanning detection rule (mutation)
ac3_check_trust — Check trust score and recommendation for an agent by DID (read only)
ac3_attest — Submit a peer attestation (positive/negative/neutral) for an agent (mutation)
ac3_record_interaction — Record an agent interaction outcome for trust scoring (mutation)
ac3_report_anomaly — Report an anomaly detected for an agent (mutation)
ac4_check_threat — Check an agent against threat intelligence database by DID (read only)
ac4_submit_indicator — Submit a threat indicator to the intelligence database (mutation)
ac4_intel_summary — Get global threat intelligence summary (read only)
ag_full_check — Full agent check — verify identity + trust score + threat intel in parallel (mutation)
ac6_list_frameworks — List supported compliance frameworks (EU AI Act, NIST, ISO 42001, SOC2, OWASP LLM Top 10) (read only)
ac6_get_framework — Get full framework details including all controls (read only)
ac6_run_audit — Run a compliance audit against a framework (mutation)
ac6_audit_history — Get audit history filtered by framework or agent (read only)
ac6_get_audit_run — Get full details for a specific audit run (read only)
ac6_submit_evidence — Submit manual evidence for an audit run (mutation)
ac6_create_schedule — Create a recurring compliance audit schedule (mutation)
ac6_list_schedules — List audit schedules (read only)
ac6_delete_schedule — Delete an audit schedule (mutation; destructive hint)
ac7_list_personas — List available honeypot personas (read only)
ac7_list_ttps — List known TTP (Tactics, Techniques, Procedures) patterns (read only)
ac7_deploy_honeypot — Deploy a new honeypot agent to lure and detect malicious agents (mutation)
ac7_list_honeypots — List your honeypot deployments (read only)
ac7_get_honeypot — Get honeypot details (read only)
ac7_update_honeypot — Update honeypot configuration or status (mutation; destructive hint)
ac7_capture_attack — Record an attack capture against a honeypot (mutation)
ac7_get_captures — List attack captures for a honeypot (read only)
ac7_list_attacker_profiles — List attacker profiles from shadow network (read only)
ac7_get_attacker_profile — Get detailed attacker profile by fingerprint (read only)
ac7_shadow_stats — Get shadow network statistics (read only)
ac8_list_firewall_modes — List supported firewall deployment modes (read only)
ac8_create_firewall_config — Create a firewall configuration (mutation)
ac8_list_firewall_configs — List your firewall configurations (read only)
ac8_get_firewall_config — Get firewall config details with rules (read only)
ac8_update_firewall_config — Update a firewall configuration (mutation; destructive hint)
ac8_delete_firewall_config — Delete a firewall configuration (cascades all rules) (mutation; destructive hint)
ac8_create_rule — Create a firewall rule for a config (mutation)
ac8_list_rules — List rules for a firewall config (read only)
ac8_update_rule — Update a firewall rule (mutation; destructive hint)
ac8_delete_rule — Delete a firewall rule (mutation; destructive hint)
ac8_evaluate_traffic — Evaluate agent traffic against firewall rules (mutation)
ac8_firewall_events — List firewall traffic events (read only)
ac8_get_firewall_event — Get firewall event details with quarantine info (read only)
ac8_list_quarantined — List quarantined payloads (read only)
ac8_review_quarantine — Review a quarantined item — release or block permanently (mutation; destructive hint)
ac8_firewall_stats — Get firewall statistics (action breakdown, latency, top threats) (read only)
ac9_list_sensors — List supported tracker sensor types (read only)
ac9_ingest_sighting — Ingest an agent sighting — primary data entry for tracking (mutation)
ac9_list_tracked_agents — List tracked (shadow) agents with filtering and search (read only)
ac9_get_tracked_agent — Get full tracked agent profile with sightings, correlations, sensor breakdown (read only)
ac9_update_tracked_agent — Update tracked agent metadata (name, visibility, tags, notes) (mutation; destructive hint)
ac9_agent_sightings — Get sighting history for a tracked agent (read only)
ac9_add_correlation — Link two tracked agents via behavioral or campaign correlation (mutation)
ac9_agent_correlations — Get correlations for a tracked agent (read only)
ac9_tracker_alerts — Get tracker alert feed (read only)
ac9_acknowledge_alert — Acknowledge a tracker alert (mutation; destructive hint)
ac9_tracker_graph — Get relationship graph data for visualization (nodes + edges) (read only)
ac9_auto_respond — Execute auto-response for a high-risk tracked agent (creates firewall rules + threat indicators) (mutation; destructive hint)
ac9_tracker_stats — Get tracker dashboard statistics (read only)
ac10_chain_info — Get chain overview: block height, totals, validator info (read only)
ac10_list_blocks — List blocks (paginated) (read only)
ac10_get_block — Get a block by height with transactions (read only)
ac10_get_transaction — Get a transaction by ID (read only)
ac10_verify_transaction — Verify a transaction signature (read only)
ac10_list_nfts — List NFTs (filterable by owner, burned status) (read only)
ac10_get_nft — Get NFT detail with transfer history and events (read only)
ac10_get_nft_by_agent — Get NFT record by agent ID (read only)
ac10_transfer_nft — Transfer NFT ownership to a new address (mutation; destructive hint)
ac10_update_nft — Update NFT metadata or visibility (mutation; destructive hint)
ac10_burn_nft — Burn (deactivate) an NFT (mutation; destructive hint)
ac10_nft_events — Get events for an NFT (read only)
ac10_record_event — Record an on-chain event (trust_update, audit_result, risk_change, etc.) (mutation)
ac10_chain_health — Get chain health with integrity check (read only)
ac10_verify_chain — Run full chain integrity verification (mutation)
ac11_list_wallets — List wallets for your agents (read only)
ac11_get_wallet — Get wallet detail with recent transactions (read only)
ac11_fund_wallet — Fund a wallet with ACC micro-credits (mutation; destructive hint)
ac11_make_payment — Make an agent-to-agent payment (mutation; destructive hint)
ac11_refund_payment — Refund a payment (mutation; destructive hint)
ac11_open_channel — Open a micropayment channel between agents (mutation; destructive hint)
ac11_list_channels — List payment channels for an agent (read only)
ac11_get_channel — Get payment channel detail (read only)
ac11_channel_payment — Make a micropayment within a channel (mutation; destructive hint)
ac11_close_channel — Close a payment channel and settle balances (mutation; destructive hint)
ac11_payment_history — Get transaction history for an agent wallet (read only)
ac11_usage_meters — Get API usage meters for an agent (read only)
ac11_meter_api_call — Record a metered API call and charge (mutation; destructive hint)
ac11_payment_stats — Get payment statistics (read only)
ac12_list_tiers — List customization tiers with pricing and features (read only)
ac12_get_tier — Get customization tier detail (read only)
ac12_apply_customization — Apply a customization to an agent (mutation; destructive hint)
ac12_list_customizations — List your customizations (read only)
ac12_get_agent_customization — Get customization for a specific agent (read only)
ac12_update_customization — Update customization fields (mutation; destructive hint)
ac12_import_nft — Import external NFT as avatar (Premium tier only) (mutation; destructive hint)
ac12_revoke_customization — Revoke a customization (mutation; destructive hint)
ac12_supported_chains — List supported blockchain chains and tokens (read only)
ac12_supported_wallets — List supported wallet connectors (MetaMask, Phantom, Ledger, etc.) (read only)
ac12_wallets_for_chain — Get wallets that support a specific chain (read only)
ac12_connect_wallet — Connect a crypto wallet (mutation; destructive hint)
ac12_list_connected_wallets — List your connected wallets (read only)
ac12_disconnect_wallet — Disconnect a wallet (mutation; destructive hint)
ac12_create_crypto_payment — Create a crypto payment order (mutation; destructive hint)
ac12_list_crypto_payments — List crypto payment orders (read only)
ac12_confirm_crypto_payment — Confirm a crypto payment with blockchain transaction hash (mutation; destructive hint)
ac12_create_stripe_payment — Create a Stripe payment order (mutation; destructive hint)
ac12_confirm_stripe_payment — Confirm a Stripe payment (mutation; destructive hint)
ac12_treasury — Get platform treasury wallet addresses (read only)
ac12_marketplace_stats — Get marketplace statistics (read only)
ac12_submit_review — Submit a review for a marketplace listing (must be buyer) (mutation)
ac12_get_listing_reviews — Get reviews for a marketplace listing (read only)
ac12_search_listings — Search marketplace listings with filters (q, type, minPrice, maxPrice, tag, sort) (read only)
health — Agent Chain platform health check (read only)