langchain-godaddy

GoDaddy integrations for LangChain / LangGraph.

Install

pip install langchain-godaddy
# CSR generation and badge verification work out of the box.
# optional extra:
#   [agent]   run the bundled ReAct/LangGraph agent example
#             (langgraph + langchain-anthropic)

Configuration

All configuration is via environment variables (or explicit kwargs):

Discovery reads need no credentials.

Agent Identity

Register, discover, and verify AI agents through GoDaddy's Agent Identity API. The feature lives at langchain_godaddy.agent_identity; its public API is re-exported from langchain_godaddy.

See examples/chat_stream.py for a runnable end-to-end example — a streaming ReAct agent wired to the toolkit that can discover, register, and verify agents.

One-line agent setup — toolkit

from langchain_godaddy import AgentIdentityToolkit
from langchain_anthropic import ChatAnthropic
from langgraph.prebuilt import create_react_agent

tools = AgentIdentityToolkit.from_env().get_tools()  # note: synchronous
agent = create_react_agent(ChatAnthropic(model="claude-opus-4-8"), tools=tools)

The toolkit adapts to your configuration. Tools it exposes:

Always (no credentials required):

• agent_identity_search_registered_agents — free-text search of the registry, with protocol / capability / tag / status filters and trust-aware ranking.
• agent_identity_list_registered_agents — paged listing with the same filters.
• agent_identity_get_agent — fetch an agent's registration record and lifecycle status by ID.
• agent_identity_generate_csrs — generate the identity + server CSRs (RSA-2048) locally, written under GODADDY_KEYS_DIR.
• agent_identity_verify — verify a peer agent's certificate against its published identity badge (fingerprint + SAN checks).

Added when GODADDY_API_KEY is set:

• agent_identity_get_registered_agent — one registered agent with full trust explainability.
• agent_identity_register_agent — register a new agent (returns the ACME challenge).
• agent_identity_verify_acme — trigger ACME domain-control validation.
• agent_identity_verify_dns — confirm the required DNS records are live (→ ACTIVE).
• put_godaddy_txt_record — write the GoDaddy DNS TXT records the registration flow needs.

Agent registration flow

generate CSRs (local)          → csr.make_csr_tool / generate_agent_csrs
register_agent                 → returns agentId + ACME challenge
provision _acme-challenge TXT  → dns.put_godaddy_txt
verify_acme                    → PENDING_CERTS
poll get_agent                 → until PENDING_DNS (dnsRecords available)
provision _ans / _ans-badge TXT→ dns.put_godaddy_txt (×2)
verify_dns                     → ACTIVE

License

MIT.