Skip to main content
Glama

๐Ÿค– AgentTools API

Production-Grade Tool APIs for Agentic AI Systems & Enterprise Automation
High-Value Financial Document Intelligence โ€ข Token-Optimized Web Scraping โ€ข MCP Server for Claude & Cursor โ€ข Zero Third-Party API Costs

FastAPI Python MCP Glama MCP RapidAPI License: MIT


๐Ÿ› ๏ธ Flagship Agentic Tools

Tool

Endpoint

Description

Typical Use Case

๐Ÿงพ Invoice & Receipt Intelligence

POST /tools/invoice-extract

Extracts structured JSON (vendor, invoice #, dates, line items, totals, math verify)

Bookkeeping bots, ERP pipelines, CFO agents

๐Ÿ“„ PDF Document Intelligence

POST /tools/pdf-extract

Page-by-page mapping, metadata, outlines, and exact LLM token budget estimation

RAG ingestion, legal & contract analysis

๐ŸŒ Markdown Web Scraper

POST /tools/web-reader

Strips ads, navbars, and cookie banners; returns clean, token-efficient Markdown

Web research agents, documentation readers

๐Ÿ” Web Search

POST /tools/web-search

Live web search via DuckDuckGo with structured snippets

Real-time agent fact-checking

๐Ÿ“ฐ News Intelligence

POST /tools/news

Topic-based news headlines and summaries via Google News RSS

Market intelligence & news monitoring

๐Ÿ“ Text Summarizer

POST /tools/summarize

Zero-cost extractive text summarization

Context compression

โ˜๏ธ Global Weather

POST /tools/weather

Real-time global weather and multi-day forecasts

Travel & logistics agents

๐ŸŒ IP Geolocation

GET /tools/ip-info

Geolocation, ISP, and network metadata lookup

Security & localization


Related MCP server: ntriq-agentshop

โšก Feature Highlights

  • Zero External API Costs: Core tools run on-server with deterministic layout parsing and open data feeds.

  • Math-Verified Invoices: Automatic check ensures Subtotal + Tax == Total Amount Due to prevent accounting hallucination.

  • LLM Token-Budget Aware: Every document and web extraction returns word counts and estimated token usage.

  • Dual Protocol: Standard REST API with OpenAPI specification PLUS native Model Context Protocol (MCP) for Claude Desktop and Cursor.

  • Enterprise Auth & Metering: Built-in SQLite usage tracking, tier quotas (Free/Pro/Enterprise), and support for both X-API-Key and X-RapidAPI-Key.


๐Ÿš€ Quick Start

1. Clone & Set Up Virtual Environment

git clone https://github.com/kulas-100/agent-tools.git
cd agent-tools

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Environment Configuration

cp .env.example .env
# Edit .env if you wish to change your master or default API keys

3. Run the Server

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Open http://localhost:8000/docs in your browser to test endpoints via the interactive Swagger UI.


๐Ÿ“– API Usage & cURL Examples

All authenticated requests require the X-API-Key header (default key: test-api-key-12345).

1. Extract Invoice / Receipt Data

curl -X POST http://localhost:8000/tools/invoice-extract \
  -H "X-API-Key: test-api-key-12345" \
  -H "Content-Type: application/json" \
  -d '{
    "raw_text": "Acme Cloud Inc.\nTax ID: US-94829104\nINVOICE #INV-2026-8891\nDate: 2026-10-15\nDue: 2026-11-15\nBill To: Wayne Corp\nGPU Compute 2 $ 450.00 $ 900.00\nSubtotal: $ 900.00\nTax: $ 90.00\nTotal: $ 990.00"
  }'

Response:

{
  "success": true,
  "invoice": {
    "document_type": "invoice",
    "invoice_number": "INV-2026-8891",
    "vendor_name": "Acme Cloud Inc.",
    "vendor_tax_id": "US-94829104",
    "customer_name": "Wayne Corp",
    "invoice_date": "2026-10-15",
    "due_date": "2026-11-15",
    "currency": "USD",
    "subtotal": 900.0,
    "tax_amount": 90.0,
    "total_amount": 990.0,
    "line_items": [
      {
        "description": "GPU Compute",
        "quantity": 2.0,
        "unit_price": 450.0,
        "total_price": 900.0
      }
    ]
  },
  "confidence_score": 1.0,
  "math_verified": true,
  "processing_time_ms": 19.4
}

2. Scrape Webpage to Clean Markdown

curl -X POST http://localhost:8000/tools/web-reader \
  -H "X-API-Key: test-api-key-12345" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "include_links": true}'

3. Parse PDF Document with Token Budgets

curl -X POST http://localhost:8000/tools/pdf-extract \
  -H "X-API-Key: test-api-key-12345" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf", "max_pages": 5}'

๐Ÿค– Model Context Protocol (MCP) Integration

Connect AgentTools directly to Claude Desktop or Cursor:

Claude Desktop Configuration (claude_desktop_config.json)

{
  "mcpServers": {
    "agenttools": {
      "command": "/absolute/path/to/agent-tools/.venv/bin/python",
      "args": ["/absolute/path/to/agent-tools/mcp_server.py"]
    }
  }
}

๐ŸŒ Public Marketplace Listing


๐Ÿ“„ License

MIT License. Free for commercial and personal development.

Available Tools

9 tools
calculatorA

Safely evaluate mathematical and scientific expressions using an isolated AST evaluator without unsafe execution. Supports arithmetic (+, -, *, /, **), trigonometry (sin, cos, tan), logarithms, square roots, and factorials. Use whenever exact numeric precision is required to avoid arithmetic hallucinations. Pure, deterministic, and idempotent.

Inputs: expression (required).

get_ip_infoA

Retrieve geolocation, country, city, geographic coordinates, ISP, and timezone metadata for an IP address. Use to inspect IP locations, detect regional origins, or resolve server IP information. Read-only and idempotent.

Inputs: ip.

get_newsA

Fetch current news headlines, summaries, sources, and publication timestamps for any topic or keyword via Google News RSS. Use when monitoring breaking news, market updates, or industry trends. Read-only and idempotent.

Inputs: topic (required), max_articles.

get_weatherA

Get current weather conditions (temperature, humidity, wind speed, weather code) and multi-day daily forecasts for any city or geographic location worldwide via Open-Meteo. Use when answering weather queries or trip planning. Read-only and idempotent.

Inputs: location (required), forecast_days.

invoice_extractA

Extract structured financial data (vendor, invoice #, PO #, dates, line items, subtotal, tax, total, currency) from invoices, receipts, and bills, verifying mathematical consistency (subtotal + tax == total). Use when processing accounting documents or receipts. Do not use for generic documents. Read-only and idempotent.

Inputs: url, raw_text, file_base64, currency_hint.

pdf_extractA

Extract text per page, outlines, document metadata, and accurate token count estimates from PDF documents. Use when ingesting multi-page reports, whitepapers, contracts, or legal documents into context. Read-only and idempotent.

Inputs: url, max_pages, start_page, file_base64.

summarizeA

Perform extractive text summarization to identify and return the most informative, central sentences from long articles or documents based on term-frequency scoring. Use to compress long context into key points. Pure, deterministic, and idempotent.

Inputs: text (required), num_sentences.

web_readerA

Fetch a public webpage URL and extract clean, structured Markdown optimized for LLM token efficiency, stripping headers, footers, ads, and navigation menus. Use when reading articles, blog posts, documentation, or public web pages. Read-only and idempotent.

Inputs: url (required), max_length, include_links.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but web_search and get_news overlap for current information, and invoice_extract can be confused with pdf_extract when invoices are PDFs. Descriptions largely help route correctly.

    Naming Consistency3/5

    All names use snake_case, but the conventions are mixed: verb_noun (get_weather), noun_verb (invoice_extract), noun (calculator), and bare verb (summarize). The names remain readable, but there is no single predictable pattern.

    Tool Count5/5

    Nine tools is well within the typical 3-15 range for a general agent toolkit, and each tool appears to earn its place as a distinct utility. There are no redundant variants or obvious filler tools.

    Completeness4/5

    The set covers a reasonable agent utility surface: document extraction, web reading/search, weather, math, news, summarization, and IP metadata. Some common gaps remain, such as generic file-format handling, OCR, or date/time utilities, but these are minor enough to work around.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      AI-native business management โ€” invoices, expenses, clients, products, quotes, and webhooks. 31 tools for Claude, Cursor, Windsurf, and Cline.
      100
      1,117 npm
      13
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      File-based multi-agent coordination with persistent tasks, reports, issues and reviews. FCoP 4.0.5 provides 25 canonical MCP tools and 6 read-only resources over local stdio. Work stays in your project as Markdown records, with task lifecycle validation and branch workflows. Includes a Python API and a CLI for setup, inspection and diagnostics.
      25
      64 PyPI
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP bridge for PDF Content Search โ€” full-text PDF search with Apple Vision OCR across thousands of documents in under a second from Claude, Cursor, or any MCP client. Advanced filters (date, category, sender, amount), wildcards, boolean operators. Bridge open-source (MIT), PDF Content Search app is commercial with free iOS+Android companion scanner apps.
      84
      1
      MIT