Skip to content

About

VoltAgent tools on Datacircle's open API: find the best GTM APIs. No key needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Datacircle tools for VoltAgent

Find the best GTM APIs. We benchmark all the GTM APIs and we put the results on our website.

Our website: https://datacircle.dev

This package gives VoltAgent four tools that call Datacircle's open API, https://api.datacircle.dev/v1. You need no key and no account.

Tool What the tool gives Call
datacircle_list_apis Every GTM API on Datacircle, with the API's slug, number of plans, number of providers and best plan GET /apis
datacircle_best_plans One API's plans, sorted by score out of 100, best first. Each plan comes with a rank and a price per 1,000 calls GET /apis/{slug}/best
datacircle_search_plans Plans that match a provider or plan name, on all APIs or on one API. You can sort them by score, provider or price GET /plans
datacircle_provider The APIs a provider sells, and the provider's rank on each API GET /providers/{slug}

Install

npm install @datacircle/voltagent @voltagent/core zod

The package works with VoltAgent 2.x (@voltagent/core 2.0.0 and later) and zod 3.25 or 4. It works from ESM and from CommonJS.

Use the tools

Give the tools to an agent:

import { Agent } from '@voltagent/core';
import { datacircleTools } from '@datacircle/voltagent';

const agent = new Agent({
  name: 'gtm-apis',
  instructions: 'You find the best GTM APIs for the user.',
  model: 'openai/gpt-5-mini',
  tools: datacircleTools(),
});

const result = await agent.generateText('Who are the 3 best providers for the email-finder API?');
console.log(result.text);

The model string reads OPENAI_API_KEY and needs @voltagent/core 2.2 or later. On 2.0 and 2.1, give the agent a model from the AI SDK, like openai('gpt-5-mini') from @ai-sdk/openai.

datacircleToolkit() gives the same four tools as a VoltAgent toolkit named datacircle. Put it in an agent's tools next to your other tools. When you serve the agent with new VoltAgent({ agents: { agent }, server: honoServer() }), the server also runs each tool at POST /tools/{name}/execute.

You can call each tool alone: listApis(), bestPlans(), searchPlans() and providerRanks().

import { bestPlans } from '@datacircle/voltagent';

const answer = await bestPlans().execute({ slug: 'email-finder', limit: 3 });
console.log(answer.plans);

Each tool gives back a JSON object. Each plan comes with a rank, provider, plan, score, price per 1,000 (perThousand, in dollars) and a page on datacircle.dev. That page lists every field. When the API gives no data, for example for an unknown slug, the tool returns {"error": "..."} with the API's message. The model can then call again. When the input does not fit the schema, the agent gives the model the validation error. If the network fails, the tool throws an error.

datacircleTools({ fetch }) sets the fetch the tools use, for example to add a proxy or a timeout. The toolkit and each tool function take the same options.

Network

Each tool call makes one HTTPS GET request to https://api.datacircle.dev/v1 and nothing else. The request holds only the tool's own arguments: no key and nothing from your chats. The API takes up to 60 calls a minute from one IP address. The tool waits once, for a minute at most, when the API asks the tool to wait. The package depends only on @voltagent/core and zod, and stores nothing.

Links

MIT license.

About

VoltAgent tools on Datacircle's open API: find the best GTM APIs. No key needed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages