Developer Documentation

Build with AgentHermes

Integrate the Agent Readiness Score into your agent workflows. REST API, MCP server, SDKs, and framework tools.

Quick Start MCP Integration API Reference Authentication SDKs Discovery Files Rate Limits

Quick Start

Get an Agent Readiness Score in three lines. No signup required for public endpoints.

bashcurl -- score any domain instantly

curl -s https://agenthermes.ai/api/v1/score/example.com | jq

# Full 9-dimension scan
curl -s -X POST https://agenthermes.ai/api/v1/scan \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

typescriptTypeScript SDK

import { AgentHermes } from '@agenthermes/sdk'

const hermes = new AgentHermes()

// Quick score lookup
const score = await hermes.score('example.com')
console.log(score.score, score.tier)  // 73 "gold"

// Full 9-dimension scan
const scan = await hermes.scan('example.com')
console.log(scan.dimensions)  // { discoverability: 18, interoperability: 15, ... }

// Discover agent-ready businesses
const results = await hermes.discover({ q: 'payment processing', minScore: 60 })
console.log(results.businesses)

pythonPython SDK

from agenthermes import AgentHermes

hermes = AgentHermes()

# Quick score lookup
score = hermes.score("example.com")
print(score.score, score.tier)  # 73 "gold"

# Full 9-dimension scan
scan = hermes.scan("example.com")
print(scan.dimensions)  # {"discoverability": 18, "interoperability": 15, ...}

# Discover agent-ready businesses
results = hermes.discover(q="payment processing", min_score=60)
print(results.businesses)

MCP Integration

Connect any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, etc.) to the AgentHermes MCP server. Full JSON-RPC 2.0 and SSE transports.

Endpoints

POSThttps://agenthermes.ai/api/mcpJSON-RPC 2.0

GEThttps://agenthermes.ai/api/mcp/sseServer-Sent Events

7 Tools

discover_businessesSearch by capability, vertical, tier, or price

get_business_profileFull business profile by slug

get_business_manifestMachine-readable manifest (services, pricing, auth, readiness)

run_auditTrigger Agent Readiness Score audit on a URL

check_wallet_balanceCheck business wallet balance (auth required)

initiate_paymentWallet-to-wallet payment between businesses (auth required)

verify_hermes_jsonVerify a .well-known/agent-hermes.json signature and score

4 Resources

agenthermes://businessesAll businesses in the network

agenthermes://business/{slug}Individual business profile

agenthermes://audits/{domain}Audit history for a domain

agenthermes://servicesAll active services

3 Prompts

audit-url(url)

Run an Agent Readiness Score audit

find-service(query, max_price)

Find a service by capability

check-readiness(domain)

Check if a business is agent-ready

jsonClaude Desktop config (~/.claude/mcp.json)

{
  "mcpServers": {
    "agenthermes": {
      "url": "https://agenthermes.ai/api/mcp/sse"
    }
  }
}

jsonAlternative: Cursor / generic MCP client

{
  "mcpServers": {
    "agenthermes": {
      "transport": "sse",
      "url": "https://agenthermes.ai/api/mcp/sse"
    }
  }
}

API Reference

All endpoints live under https://agenthermes.ai/api/v1/. Full OpenAPI 3.0 spec available at /openapi.json.

Endpoints marked AUTH require a Bearer token or API key in the Authorization header.

Scanning & Scoring

POST/api/v1/scan

9-dimension Agent Readiness scan

POST/api/v1/scan/batchAUTH

Batch scan multiple domains

GET/api/v1/score/{domain}

Quick score lookup

POST/api/v1/audit

Legacy 5-category audit

GET/api/v1/audit/{id}

Get audit result by ID

Discovery & Search

GET/api/v1/discover

Search agent-ready businesses

GET/api/v1/discover/semantic

Semantic vector search

GET/api/v1/discover/services

Search services across businesses

GET/api/v1/leaderboard

Agent readiness leaderboard

Business Management

POST/api/v1/business

GET/api/v1/business/{slug}

Get business profile

PATCH/api/v1/business/{slug}AUTH

Update business profile

GET/api/v1/business/{slug}/manifest

Machine-readable manifest

GET/api/v1/business/{slug}/services

List services

POST/api/v1/business/{slug}/servicesAUTH

PATCH/api/v1/business/{slug}/servicesAUTH

Update a service

DELETE/api/v1/business/{slug}/servicesAUTH

Remove a service

POST/api/v1/business/{slug}/api-keysAUTH

Generate API key

GET/api/v1/business/{slug}/api-keysAUTH

List API keys

DELETE/api/v1/business/{slug}/api-keysAUTH

Revoke API key

POST/api/v1/business/{slug}/connectAUTH

Stripe Connect onboarding

Trust & Certification

GET/api/v1/trust-score/{slug}

Composite trust score breakdown

POST/api/v1/certifyAUTH

Certify a business

GET/api/v1/certify

Get certification status

GET/api/v1/certify/badge/{slug}

SVG certification badge

GET/api/v1/benchmarks

Industry benchmarks by vertical

GET/api/v1/benchmarks/compare

Compare against benchmarks

POST/api/v1/hermes-jsonAUTH

Generate signed hermes.json

POST/api/v1/hermes-json/verify

Verify hermes.json signature

Wallet & Payments

GET/api/v1/walletAUTH

Get wallet balance

POST/api/v1/wallet/fundAUTH

Add funds to wallet

POST/api/v1/wallet/transferAUTH

Wallet-to-wallet transfer

GET/api/v1/wallet/transactionsAUTH

Transaction history

Remediation (Auto-fix Generators)

POST/api/v1/remediate/llms-txt

Generate llms.txt for a domain

POST/api/v1/remediate/agent-card

Generate A2A agent card

POST/api/v1/remediate/schema-org

Generate Schema.org JSON-LD

POST/api/v1/remediate/mcp-proxy

Generate MCP proxy config

POST/api/v1/remediate/openapi-to-mcp

Convert OpenAPI to MCP tools

Health & Monitoring

POST/api/v1/health/checkAUTH

Trigger endpoint health check

GET/api/v1/health/status

Health status for a business

POST/api/v1/monitoringAUTH

Trigger monitoring cycle

GET/api/v1/monitoringAUTH

List monitoring events

GET/api/v1/monitoring/eventsAUTH

Filtered event log

POST/api/v1/mystery-shopAUTH

Trigger mystery shop

GET/api/v1/mystery-shopAUTH

Mystery shop history

Webhooks

POST/api/v1/webhooks/subscribeAUTH

Subscribe to events

GET/api/v1/webhooks/subscribeAUTH

List subscriptions

DELETE/api/v1/webhooks/subscribeAUTH

Unsubscribe

Authentication

Public endpoints (score lookup, discovery, audits) require no authentication. Business management, wallet, webhook, and monitoring endpoints require a Bearer token.

How it works

1.Register your business via POST /api/v1/business
2.Generate an API key via POST /api/v1/business/{slug}/api-keys
3.Pass the key as a Bearer token in every authenticated request

bashAuthenticated request example

curl -s https://agenthermes.ai/api/v1/wallet?business_id=YOUR_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# Or via X-API-Key header
curl -s https://agenthermes.ai/api/v1/wallet?business_id=YOUR_ID \
  -H "X-API-Key: YOUR_API_KEY"

typescriptSDK authentication

import { AgentHermes } from '@agenthermes/sdk'

const hermes = new AgentHermes({
  apiKey: process.env.AGENTHERMES_API_KEY,
})

// Authenticated endpoints now work
const wallet = await hermes.wallet.balance()
const keys = await hermes.apiKeys.list()

SDKs & Framework Tools

Official SDKs for TypeScript and Python, plus pre-built tools for LangChain and CrewAI.

TypeScript / Node.js

npm / pnpm / yarn / bun

bashInstall

npm install @agenthermes/sdk

Python

pip / uv / poetry

bashInstall

pip install agenthermes

LangChain Tools

Drop-in LangChain tool wrappers

pythonUsage

from agenthermes.langchain import (
    AgentHermesScoreTool,
    AgentHermesDiscoverTool,
)

tools = [AgentHermesScoreTool(), AgentHermesDiscoverTool()]
agent = initialize_agent(tools, llm)

CrewAI Tools

CrewAI-compatible tool wrappers

pythonUsage

from agenthermes.crewai import (
    AgentHermesScoreTool,
    AgentHermesDiscoverTool,
)

researcher = Agent(
    role="Business Researcher",
    tools=[AgentHermesScoreTool(), AgentHermesDiscoverTool()],
)