AgentTools
AgentTools is an MCP server for document intelligence, token-efficient web access, utilities, and financial extraction.
Extract invoice/receipt data from URLs, raw text, or Base64 files, including vendor, dates, line items, totals, tax, and currency hints.
Parse PDFs page-by-page via URL or Base64, returning text, metadata, and estimated token counts with page controls.
Fetch public webpages as clean, LLM-friendly Markdown with optional link catalogs and length limits.
Search the web via DuckDuckGo and return structured results.
Get current weather and multi-day forecasts worldwide.
Safely evaluate math expressions, including arithmetic, trig, logs, sqrt, and factorial.
Fetch latest news headlines and summaries by topic.
Summarize long text into key sentences.
Look up IP geolocation, ISP, and network metadata.
Provides live web search via DuckDuckGo with structured snippets, enabling agents to perform real-time fact-checking and web research.
Provides topic-based news headlines and summaries via Google News RSS for market intelligence and news monitoring.
๐ค 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
๐ ๏ธ Flagship Agentic Tools
Tool | Endpoint | Description | Typical Use Case |
๐งพ Invoice & Receipt Intelligence |
| Extracts structured JSON (vendor, invoice #, dates, line items, totals, math verify) | Bookkeeping bots, ERP pipelines, CFO agents |
๐ PDF Document Intelligence |
| Page-by-page mapping, metadata, outlines, and exact LLM token budget estimation | RAG ingestion, legal & contract analysis |
๐ Markdown Web Scraper |
| Strips ads, navbars, and cookie banners; returns clean, token-efficient Markdown | Web research agents, documentation readers |
๐ Web Search |
| Live web search via DuckDuckGo with structured snippets | Real-time agent fact-checking |
๐ฐ News Intelligence |
| Topic-based news headlines and summaries via Google News RSS | Market intelligence & news monitoring |
๐ Text Summarizer |
| Zero-cost extractive text summarization | Context compression |
โ๏ธ Global Weather |
| Real-time global weather and multi-day forecasts | Travel & logistics agents |
๐ IP Geolocation |
| 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 Dueto 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-KeyandX-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.txt2. Environment Configuration
cp .env.example .env
# Edit .env if you wish to change your master or default API keys3. Run the Server
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000Open 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
RapidAPI Hub: rapidapi.com/kulas100/api/agenttools
Smithery.ai MCP: Import repository via
smithery.yaml
๐ License
MIT License. Free for commercial and personal development.
Available Tools
9 toolscalculatorA
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.
web_searchA
Search the live web using DuckDuckGo to retrieve real-time search results, titles, URLs, and text snippets. Use when you need current facts, external references, or breaking information not in your training data. Read-only and idempotent.
Inputs: query (required), max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
Pay-per-use agent tools: screenshots, web to Markdown, PDF tables, OCR, UK company checks
Web pages and PDFs to clean, LLM-ready Markdown with token counts, small crawls and RAG chunks.
Stateless agentic tools over MCP: concept extraction, long-context, knowledge graph, planning.
Web tools for AI agents: URL to clean Markdown, site crawl, screenshots, PDF/Office to text, OCR.
Related MCP Servers
- AlicenseBqualityAmaintenanceAI-native business management โ invoices, expenses, clients, products, quotes, and webhooks. 31 tools for Claude, Cursor, Windsurf, and Cline.1001,117 npm13MIT
- AlicenseAqualityCmaintenanceMCP server for document intelligence via x402 micropayments. 6 tools: document analysis, invoice extraction, screenshot data, alt text, PII detection, sentiment analysis. Pay-per-use with USDC on Base โ no API keys needed.61 npmMIT
- AlicenseCqualityBmaintenanceFile-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.2564 PyPI3MIT
- AlicenseBqualityCmaintenanceMCP 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.841MIT