Skip to content

tollbit/.github

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TollBit

A managed entrypoint to any web app, specifically meant for AI agents. Direct, authorized, and reliable agent <-> service interactions for any web service on the internet.

Why TollBit Exists

It's no secret that AI agents are going to run the web in the near future. However, for that to become a reality, the way agents interact with the internet needs to change. Currently, agent builders' options are limited to typical developer APIs and/or web automation. While great for demos, these patterns seem like the initial "hack" waiting for a more long term solution.

Developer APIs work well, but there is a very short list beyond the overused Google Drive, Slack, etc. Web automation is extremely slow, unreliable and insecure. Not only that, but most websites don't want bots on them, leading to doing all the grunt work of solving captchas and avoiding getting blocked.

The main reason for all this trouble? The web was not built for agents to be first class citzens.

TollBit aims to build critical infrastructure that opens up new pathways for agents to act on the web, at native speed, and to actually bring real value to their users.

We are building on one ethical principle: agents shouldn't (need to) pretend to be humans on the internet.

This approach solves problems for both sides: website owners gain a reliable way to identify legitimate AI agents, manage their access privileges, and monetize their usage, while AI developers get stable, authorized access to first-party APIs, content, or web UI.

How TollBit Works

TollBit creates a gateway for AI agents through a simple convention:

Any service with a tollbit subdomain (tollbit.example.com) explicitly welcomes agent access with standardized authorization, permissions, and monetization.

We call this subdomain the "front door" - a dedicated entry point built specifically for AI agents, separate from human traffic.

flowchart LR
    %% Define the AI agent client
    A[AI Agent with<br>TollBit Client]

    %% Define the TollBit front doors
    B1[tollbit.service-a.com]
    B2[tollbit.service-b.com]
    B3[tollbit.service-c.com]

    %% Define the actual services
    C1[service-a.com]
    C2[service-b.com]
    C3[service-c.com]

    %% Define the human user (simple)
    H[Human User]

    %% Connect AI agent to TollBit front doors
    A -->|"HTTP"| B1
    A -->|"HTTP"| B2
    A -->|"HTTP"| B3

    %% Connect human to just service-a
    H -->|"Browser"| C1

    %% Connect TollBit front doors to actual services - no labels
    B1 --- C1
    B2 --- C2
    B3 --- C3
Loading

TollBit Among the Ecosystem

TollBit is intentionally built to improve, not compete with the existing ecosystem. TollBit is the closest layer to the web service. Other frameworks specify how agents interact and communicate with that layer.

  • Model Context Protocol (MCP): All TollBit services are MCP-compatible, making them plug-and-play with Anthropic's models. TollBit is the "what", and MCP is the "how" for agents making requests on the web.
  • OpenAPI: Works alongside API specifications while adding agent-specific authentication and monetization
  • AI Agent Frameworks: Provides a consistent target for agent tools regardless of underlying architecture
flowchart LR
    %% Define the AI agent client
    A[AI Agent]

    %% Define individual MCP servers
    M3[MCP Server C]

    %% Define the human user (simple)
    H[Human User]

    %% Define the TollBit front doors
    B1[tollbit.service-a.com]
    B2[tollbit.service-b.com]
    B3[tollbit.service-c.com]

    %% Define the actual services
    C1[service-a.com]
    C2[service-b.com]
    C3[service-c.com]

    %% Connect AI agent to MCP servers
    A -->|"HTTP"| B1
    A -->|"MCP Protocol"| B2
    A -->|"MCP Protocol"| M3

    %% Connect MCP servers to TollBit front doors
    M3 -->|"HTTP"| B3

    %% Connect human to just service-a
    H -->|"Browser"| C1

    %% Connect TollBit front doors to actual services
    B1 --- C1
    B2 --- C2
    B3 --- C3
Loading

For Service Providers

TollBit lets you monetize AI agent access to your service without building custom infrastructure:

  • Implement once, work with any TollBit-compatible agent
  • Set different pricing tiers and usage limits
  • Separate human and bot traffic transparently
  • Prevent abuse through standardized authentication

For AI Developers

TollBit gives your agents reliable access to services:

  • One consistent pattern for authentication and access
  • No more brittle web automation that breaks with UI changes
  • Clear permissions model designed for non-human users
  • Focus on building intelligence, not maintaining integration code

Agent Builder Quickstart

Start with a sample Stagehand app.

npx create-browser-app

Install the TollBit client with Stagehand Plugin

npm i @tollbit/stagehand

Add this code to your stagehand app.

import { TollbitStagehandPlugin } from "@tollbit/stagehand";

/*
other code...
*/

// Initialize Tollbit with your configuration
const tollbit = TollbitStagehandPlugin.fromConfig({
  clientConfig: {
    apiKey: process.env.TOLLBIT_API_KEY!,
    userAgent: "TestBot/1.0",
  },
});

/*
other code...
*/

const context = stagehand.context;

// Attach TollBit to the browser context
await tollbit.attachToContext(context);

/*
use stagehand as normal!
*/

About

README for Tollbit

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors