For developers

The SDK behindagent-ready sites.

Publish your site’s actions as WebMCP tools, know which agents are calling them, and decide what each one may do. Agent Nic writes it for you, or you write it yourself.

app/agentronics.ts
import { Agentronics } from '@agentronics/sdk'

const client = Agentronics.init({
  publishableKey: process.env.NEXT_PUBLIC_AGENTRONICS_KEY!,
  siteId: 'shop',
})

client.registerTool({
  name: 'search_products',
  title: 'Search products',
  description: 'Search the catalogue by keyword.',
  inputSchema: { type: 'object', properties: { query: { type: 'string' } } },
  annotations: { readOnlyHint: true },
  execute: async ({ query }) => searchCatalogue(query),
})

client.publishToWebMcp()
// → document.modelContext.registerTool(…)

What’s in the SDK

Six parts, one install.

npm install @agentronics/sdk. Every part reports to the same console.

  • WebMCP tools

    Publish typed tools with document.modelContext. See each tool's status (callable, failed) and token cost per page.

  • Detection

    WebMCP agents, browser automation, vision-model agents that drive the page by screenshots, self-declared agents and crawlers.

  • Authentication

    Verified crawlers (published IP ranges + reverse DNS), agent API keys, Web Bot Auth signatures and OAuth 2.1 with delegation.

  • Authorization

    Allow, deny, or review: ask the person on the page first. Deny makes a tool uncallable; it never blocks browsing.

  • Procedural memory

    AI-rewritten tool descriptions with before/after token counts. Approve them in the console; the SDK serves them.

  • Observability

    Every detection, auth decision and tool call as a trace: sessions, latency, failures, and export.

Agent Nic

Or let Agent Nic write it.

Connect a GitHub repository. Agent Nic reads your routes and forms, writes the WebMCP tools with the SDK, adds a sitemap, llms.txt and structured data if they’re missing, and opens a pull request. From Starter up, it also fixes CI failures on that pull request.

  1. 1

    Connect a GitHub repository

  2. 2

    Agent Nic proposes tools, page by page

  3. 3

    You review the pull request and merge

Start with the quickstart.

Five steps from npm install to your first agent call in the console.

Open the quickstart