Agent Tools

Deterministic data transformation and formatting for AI agents.

An open source project by atmatic.ai

Agent Tools is an agent-driven data utility platform that provides deterministic tools for transforming, formatting, and inspecting structured data. Designed for MCP and A2A systems, Agent Tools ensures that when agents act, the resulting data is correct, inspectable, and production-ready.

Why Agent Tools?

LLMs think. Agent Tools executes.

While LLMs excel at reasoning and understanding intent, they struggle with:

• Large files (MB–GB): Token limits cause truncation

• Strict correctness: One missing comma = broken output

• Binary formats: PDF operations require precise byte manipulation

• Repeatability: Enterprise needs deterministic, auditable results

• Security: Air-gapped environments, no data leakage

Agent Tools provides the authoritative execution layer that agents can trust.

Related MCP server: mcp-micro-tools

Live Demo

Try Agent Tools instantly without any installation:

https://tools.atmatic.ai

This is a hosted version of the open source code — the same tools, same features, running on managed infrastructure.

Screenshots

Browse screenshots of all 18 tools in the screenshots directory:

• Homepage

• JSON Studio

• CSV Viewer

• PDF Toolkit

• PDF - Extract Template

• PDF - Generate from Template

• XML Studio

• Excel Viewer

• Image Toolkit

• Markdown Studio

• Archive Manager

• Regex Tester

• Diff & Patch

• SQL Studio

• Crypto & Encoding

• Date/Time Tools

• Text Utilities

• Math Utilities

• Color Utilities

• Connect (Integration Guide)

• Settings

Features

JSON Studio

• Tree view with expand/collapse navigation

• Format with configurable indentation (2/4/tabs)

• JSON Schema validation

• JSONPath/JMESPath queries

• Convert between JSON, JSON5, JSONC, YAML, TOML

• Side-by-side diff comparison

• Deep search with regex

CSV Viewer

• Virtual scrolling for 100k+ rows

• Column sort, filter, hide, reorder

• Auto-detect data types

• Export to CSV, JSON, Excel

• Column statistics and distributions

PDF Toolkit

• Merge multiple PDFs with page selection

• Split by page ranges

• Drag-and-drop page reordering

• Thumbnail previews

• Rotate, compress, extract text

• View/edit metadata

• Extract reusable templates from PDFs (detects {{placeholder}} fields)

• Generate PDFs from templates with data replacement

XML Studio

• Parse XML to JSON with configurable options

• Format/pretty-print and minify XML

• Validate XML structure

• Query XML with path expressions

• Convert between XML and JSON

• XML document statistics (elements, attributes, depth)

Excel Viewer

• Upload and parse .xlsx files

• View sheet data in tabular format

• Export to CSV, TSV, JSON

• Workbook statistics and sheet listing

• Create Excel files from JSON data

Image Toolkit

• Resize images with fit options (cover, contain, fill)

• Convert between PNG, JPEG, WebP, AVIF, TIFF

• Compress images with quality control

• Extract EXIF metadata and image stats

• Rotate, flip, crop, grayscale, blur

Markdown Studio

• Convert between Markdown, HTML, and plain text

• Generate table of contents from headings

• Extract links and frontmatter

• Document statistics (words, headings, links, images)

Archive Manager

• Upload and inspect ZIP archives

• List archive contents with sizes

• Extract files from archives

• Archive statistics (file count, total/compressed size)

Regex Tester

• Test regex patterns against text with live matching

• Search and replace with regex

• Extract matching groups and captures

• Validate regex pattern syntax

• Configurable flags (global, case-insensitive, multiline)

Diff & Patch

• Compare texts at line, word, or character level

• Generate unified diff format

• Apply patches to source text

• Diff statistics (additions, deletions, unchanged)

SQL Studio

• Format and pretty-print SQL queries

• Minify SQL

• Validate SQL syntax

• Parse SQL to AST

• Convert between dialects (PostgreSQL, MySQL, SQLite, TransactSQL, BigQuery)

• Query statistics (tables, columns, joins)

Crypto & Encoding

• Hash text with MD5, SHA-1, SHA-256, SHA-384, SHA-512

• Encode/decode Base64, Hex, URL, HTML

• Decode JWT tokens (header + payload)

• Generate cryptographically secure UUID v4

• HMAC signatures and file checksums

Date/Time Tools

• Parse date strings and timestamps

• Format dates with custom patterns

• Date arithmetic (add/subtract days, hours, etc.)

• Calculate differences between dates

• Convert between timezones

• Parse and explain cron expressions

Text Utilities

• Convert text case (upper, lower, title, sentence, camel, snake, kebab)

• Generate URL-friendly slugs

• Generate lorem ipsum placeholder text

• Calculate text similarity (Levenshtein distance)

• Text statistics (characters, words, sentences, paragraphs)

• Render mustache-style templates

• Truncate text with ellipsis options

Math Utilities

• Convert between number bases (binary, octal, decimal, hex)

• Unit conversion (length, weight, temperature, data size)

• Number formatting with locale support

• Percentage calculations

• Statistical functions (mean, median, mode, std dev, variance)

Color Utilities

• Parse colors from various formats (hex, rgb, hsl, named)

• Convert between color formats

• Check WCAG contrast ratios for accessibility

• Blend and mix colors

• Generate color palettes (complementary, triadic, analogous)

• Get nearest named color

Physics Calculator

• Physical constants lookup by key or category

• Kinematics equations, projectile motion, free fall

• Force, energy, momentum, gravity, orbital mechanics

• Ohm's law, resistors, Coulomb's law, capacitors, RC circuits

• Wave equation, Snell's law, Doppler effect, thin lens

• Ideal gas law, heat transfer, Carnot efficiency

• Lorentz factor, time dilation, mass-energy equivalence

• Physics unit conversions (force, energy, power, pressure, speed)

Structural Engineering

• Normal stress, shear stress, strain, Young's modulus, factor of safety

• Hoop stress for thin-walled pressure vessels

• Simply supported and cantilever beam analysis (point, uniform, triangular loads)

• Euler column buckling with various end conditions

• Slenderness ratio classification (short/intermediate/long)

• Cross-section properties: rectangle, circle, hollow circle, I-beam

• Terzaghi bearing capacity for strip, square, and circular foundations

• Rankine lateral earth pressure (active, passive, at-rest)

• Elastic settlement calculations

• Structural material database (11 materials: steel, aluminum, concrete, timber)

Agent Integration

Agent Tools supports three integration patterns:

1. MCP (Model Context Protocol)

Expose tools to Claude Desktop, Claude Code, or any MCP-compatible client.

Supported transports:

• stdio - For local process communication

• SSE - Server-Sent Events for web clients

• HTTP Streaming - Streamable HTTP for scalable deployments

// claude_desktop_config.json
{
  "mcpServers": {
    "agent-tools": {
      "command": "npx",
      "args": ["@atmaticai/agent-tools"]
    }
  }
}

Available MCP Tools (136):

2. A2A (Agent-to-Agent Protocol)

Agent Tools exposes an A2A-compliant agent for inter-agent communication.

# Discover agent capabilities
curl https://your-agent-tools-instance/.well-known/agent.json

# Create a task
curl -X POST https://your-agent-tools-instance/a2a/tasks \
  -H "Content-Type: application/json" \
  -d '{"skill": "json-operations", "input": {"action": "format", "data": "..."}}'

# Poll for result
curl https://your-agent-tools-instance/a2a/tasks/{task_id}

3. REST API

Direct HTTP access to all tools. No external API keys or services required — everything runs locally.

# Format JSON
curl -X POST /api/json/format \
  -H "Content-Type: application/json" \
  -d '{"input": "{\"a\":1}", "options": {"indent": 2}}'

# Format SQL
curl -X POST /api/sql/format \
  -H "Content-Type: application/json" \
  -d '{"input": "SELECT * FROM users WHERE active=true", "dialect": "postgresql"}'

# Hash text
curl -X POST /api/crypto/hash \
  -H "Content-Type: application/json" \
  -d '{"input": "hello world", "algorithm": "sha256"}'

# Parse date
curl -X POST /api/datetime/parse \
  -H "Content-Type: application/json" \
  -d '{"input": "2024-01-15T10:30:00Z", "timezone": "America/New_York"}'

# Test regex
curl -X POST /api/regex/test \
  -H "Content-Type: application/json" \
  -d '{"input": "hello world", "pattern": "\\w+", "flags": "g"}'

Available REST endpoints: /api/{tool}/{action} where tool is one of: json, csv, pdf, xml, excel, image, markdown, archive, regex, diff, sql, crypto, datetime, text, math, color, physics, structural.

Installation

npm

Agent Tools is published on npm under two packages:

• @atmaticai/agent-tools — MCP server with all 136+ tools (run as CLI or integrate with Claude Desktop)

• @atmaticai/agent-tools — Core library with all 18 tool modules (use programmatically in your own projects)

# MCP server (CLI + all tools)
npm install @atmaticai/agent-tools

# Core library only (programmatic usage)
npm install @atmaticai/agent-tools

Prerequisites

• Node.js 20+

• pnpm 9+

Local Development

# Clone the repository
git clone git@github.com:AtmaticAI/agent-tools.git
cd agent-tools

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Start specific services
pnpm dev:web    # Web UI only
pnpm dev:mcp    # MCP server only

Docker

# Full platform (Web + MCP + A2A)
docker-compose up -d

# Web UI only
docker run -p 3000:3000 ghcr.io/AtmaticAI/agent-tools:latest

# MCP server only
docker run ghcr.io/AtmaticAI/agent-tools:mcp

Docker Compose

version: '3.8'
services:
  agent-tools:
    image: ghcr.io/AtmaticAI/agent-tools:latest
    ports:
      - "3000:3000"  # Web UI
      - "3001:3001"  # MCP HTTP Streaming
    environment:
      # OpenTelemetry (optional — tracing disabled when unset)
      # - OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4318
      # - OTEL_SERVICE_NAME=agent-tools-web
      # Structured logging
      # - LOG_LEVEL=info
      # Google Analytics (optional — disabled when unset)
      # - NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
    volumes:
      - ./data:/app/data  # Persist runtime settings

Kubernetes

# Apply manifests
kubectl apply -f k8s/

# Verify deployment
kubectl get pods -n agent-tools
kubectl get svc -n agent-tools

Kubernetes Manifests

The k8s/ directory includes:

• namespace.yaml - Agent Tools namespace

• configmap.yaml - Configuration

• deployment.yaml - Main deployment

• service.yaml - ClusterIP service

• ingress.yaml - Ingress with TLS

• hpa.yaml - Horizontal Pod Autoscaler

AWS (ECS/Fargate)

cd terraform

# Initialize Terraform
terraform init

# Review the plan
terraform plan

# Deploy
terraform apply

Terraform Resources

• ECR - Container registry

• ECS Cluster - Fargate cluster

• ECS Service - Auto-scaled service

• ALB - Application Load Balancer

• CloudWatch - Logging and metrics

Configuration

Environment Variables

Tool categories (JSON, CSV, PDF, XML, Excel, Image, Markdown, Archive, Regex, Diff, SQL, Crypto, DateTime, Text, Math, Color, Physics, Structural) are configured at runtime via the Settings page (/settings). All tools are enabled by default. Settings are persisted to data/settings.json.

Observability

Agent Tools includes built-in support for OpenTelemetry tracing, structured logging, and Google Analytics. All three are opt-in — they activate only when the corresponding environment variables are set. With no variables configured, there is zero overhead.

OpenTelemetry (Distributed Tracing)

Captures traces for every chat API request, including LLM calls, tool executions, and user/assistant messages as span events.

Quick start with Jaeger:

# 1. Start Jaeger (all-in-one)
docker run -d --name jaeger \
  -p 16686:16686 \
  -p 4318:4318 \
  -e COLLECTOR_OTLP_ENABLED=true \
  jaegertracing/all-in-one:1.54

# 2. Start Agent Tools with tracing enabled
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 pnpm dev

# 3. Send a chat message, then open http://localhost:16686
#    Look for service "agent-tools-web" to see traces with:
#    - chat.request (parent span)
#      - llm.call (LLM API call with token usage)
#      - tool.execute.* (one span per tool invocation)
#    - chat.message events (user + assistant messages)

Works with any OTLP-compatible backend: Jaeger, Grafana Tempo, SigNoz, Honeycomb, Datadog, New Relic, etc.

Structured Logging

JSON-formatted server logs with automatic OpenTelemetry trace correlation. Every chat message (user and assistant) is logged as a structured event.

Log entries include traceId and spanId when OTel tracing is active, enabling direct correlation between logs and traces. In development, logs are pretty-printed for readability.

Example log output:

{
  "level": "info",
  "module": "chat",
  "traceId": "abc123...",
  "spanId": "def456...",
  "event": "chat.user_message",
  "sessionId": "session-uuid",
  "role": "user",
  "content": "Format this JSON: {...}",
  "model": "microsoft/Phi-4-mini-instruct",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Google Analytics (Client-Side)

Page views and custom event tracking for the web UI.

Tracked events:

MCP Server

Installation

# Global install
npm install -g @atmaticai/agent-tools

# Or run directly
npx @atmaticai/agent-tools

Transport Options

stdio (default)

For Claude Desktop and local integrations:

{
  "mcpServers": {
    "agent-tools": {
      "command": "npx",
      "args": ["@atmaticai/agent-tools"]
    }
  }
}

SSE (Server-Sent Events)

For web-based MCP clients:

npx @atmaticai/agent-tools --transport sse --port 3001

HTTP Streaming

For scalable, stateless deployments:

npx @atmaticai/agent-tools --transport http --port 3001

Connect via:

POST http://localhost:3001/mcp
Content-Type: application/json

{"jsonrpc": "2.0", "method": "tools/list", "id": 1}

A2A Agent

Agent Card

The A2A agent card is available at /.well-known/agent.json:

{
  "name": "Agent Tools Data Agent",
  "description": "Deterministic data transformation and document processing",
  "version": "1.0.0",
  "provider": {
    "organization": "atmatic.ai",
    "url": "https://atmatic.ai"
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    { "id": "json-operations", "name": "JSON Processing" },
    { "id": "csv-operations", "name": "CSV Processing" },
    { "id": "pdf-operations", "name": "PDF Processing" },
    { "id": "xml-operations", "name": "XML Processing" },
    { "id": "excel-operations", "name": "Excel Processing" },
    { "id": "image-operations", "name": "Image Processing" },
    { "id": "markdown-operations", "name": "Markdown Processing" },
    { "id": "archive-operations", "name": "Archive Management" },
    { "id": "regex-operations", "name": "Regex Operations" },
    { "id": "diff-operations", "name": "Diff & Patch" },
    { "id": "sql-operations", "name": "SQL Processing" },
    { "id": "crypto-operations", "name": "Crypto & Encoding" },
    { "id": "datetime-operations", "name": "Date/Time Operations" },
    { "id": "text-operations", "name": "Text Processing" },
    { "id": "math-operations", "name": "Math Operations" },
    { "id": "color-operations", "name": "Color Operations" },
    { "id": "physics-operations", "name": "Physics Calculator" },
    { "id": "structural-operations", "name": "Structural Engineering" }
  ]
}

Task Lifecycle

POST /a2a/tasks          → Create task (returns task_id)
GET  /a2a/tasks/:id      → Get task status/result
POST /a2a/tasks/:id/cancel → Cancel task

Coming Soon: a2ui.org Integration

a2ui.org is an emerging standard for agent user interfaces. Agent Tools will integrate as a data transformation provider within the a2ui ecosystem.

Planned Features

• Direct Connection: Register Agent Tools as a tool provider in a2ui-compatible agents

• Seamless Handoffs: Pass data between a2ui agents and Agent Tools tools

• Visual Workflows: Chain all 18 tool categories in visual pipelines

Stay tuned for updates on GitHub.

Project Structure

agent-tools/
├── apps/
│   └── web/                        # Next.js 15 application
│       ├── app/
│       │   ├── (dashboard)/        # Tool UI pages (18 tools)
│       │   │   ├── json/           # JSON Studio
│       │   │   ├── csv/            # CSV Viewer
│       │   │   ├── pdf/            # PDF Toolkit
│       │   │   ├── xml/            # XML Studio
│       │   │   ├── excel/          # Excel Viewer
│       │   │   ├── image/          # Image Toolkit
│       │   │   ├── markdown/       # Markdown Studio
│       │   │   ├── archive/        # Archive Manager
│       │   │   ├── regex/          # Regex Tester
│       │   │   ├── diff/           # Diff & Patch
│       │   │   ├── sql/            # SQL Studio
│       │   │   ├── crypto/         # Crypto & Encoding
│       │   │   ├── datetime/       # Date/Time Tools
│       │   │   ├── physics/        # Physics Calculator
│       │   │   ├── structural/     # Structural Engineering
│       │   │   ├── connect/        # Integration guide
│       │   │   └── settings/       # Runtime tool settings
│       │   └── api/                # REST API routes
│       ├── components/             # React components (shadcn/ui)
│       └── lib/                    # Utilities and stores
├── packages/
│   ├── core/                       # Shared business logic (18 modules)
│   ├── mcp-server/                 # MCP server (136 tools)
│   └── a2a-agent/                  # A2A agent (18 skills)
├── docker/                         # Docker configurations
├── k8s/                            # Kubernetes manifests
├── terraform/                      # AWS infrastructure
└── .github/workflows/              # CI/CD pipelines

Development

Commands

pnpm dev          # Start all services
pnpm build        # Build all packages
pnpm test         # Run tests
pnpm lint         # Lint code
pnpm typecheck    # Type check
pnpm format       # Format code

Testing

# Unit tests
pnpm test

# E2E tests
pnpm test:e2e

# Coverage
pnpm test -- --coverage

Managed Solution

Looking for a hosted, fully managed version of Agent Tools without the hassle of self-hosting?

Atmatic.ai offers a managed platform with enterprise-grade features including team collaboration, usage analytics, priority support, and guaranteed uptime — so you can focus on building agents, not infrastructure.

Open Source vs Managed Platform

See full comparison →

Contact us for enterprise pricing →

Contributing

See CONTRIBUTING.md for guidelines.

License

Apache 2.0 License - see LICENSE for details.

Links

• npm (MCP Server): @atmaticai/agent-tools

• npm (Core Library): @atmaticai/agent-tools

• Live Demo: tools.atmatic.ai

• Repository: github.com/AtmaticAI/agent-tools

• Organization: atmatic.ai

• Managed Platform: atmatic.ai/tools

• Issues: github.com/AtmaticAI/agent-tools/issues

• Contact: atmatic.ai/#contact-us