Real-World Ground Truth Services · Hosted MCP · High-Speed REST APIs

Ground Truth & Real-World Services for Autonomous AI Agents

Stop letting your agents hallucinate real-world data. Connect agent swarms, coding IDEs, and automated pipelines to Totus’s verified lookup engines, geospatial intelligence, and network infrastructure—via hosted MCP or low-latency REST APIs.

5,000 Free Credits Welcome Bonus Instant

No credit card required. Full unthrottled access across all MCP tools, REST APIs, and DNS services.

Claim Free Credits →
Zero Local Install
Remote Streamable HTTP
OAuth 2.1 & Bearer
IDEs & Headless Swarms
Free Tool Discovery
0 Credits for tools/list
Deterministic Hints
readOnlyHint & idempotent
Zero Friction Setup

Connect Your Agent in Seconds

Universal endpoints: https://api.totus.cloud/mcp (MCP) · https://api.totus.cloud (REST)

Add to Claude Code CLI
claude mcp add --transport http totus https://api.totus.cloud/mcp
Authenticates automatically via browser popup with zero manual token handling.
Ground Truth Utility Services

Built to Eliminate Agent Hallucinations

Deterministic data services exposed over both MCP tool schemas and high-speed REST endpoints.

validate_email

Email & Inbox Verification

readOnlyHint

Never let autonomous agents hallucinate contact viability or bounce during sales, support, or CRM outreach. Executes up to 5 progressive verification tiers:

• L1 Syntax: RFC 5322 & RFC 6531 grammar checks
• L2 DNS & Security: Live MX, SPF, DKIM, DMARC, DNSSEC & FCrDNS
• L3 SMTP Server: Zero-bounce live RCPT handshake with mail servers
• L4 Databases: Disposable, catch-all, temporary & free provider checks
• L5 Smell (AI): Inbox credibility heuristics & typo risk scoring
Cost: 0.1 – 2.25 🧩 credits (~$0.0001)

lookup_ip

IP Geolocation & Threat Intelligence

readOnlyHint

Ground your agents with real-world IP metadata for automated bot triage, fraud scoring, access gating, and location-aware decisions:

• High-Precision Geolocation: Country, region, city, coordinates, geohash, timezone
• Network Intelligence: Autonomous System (ASN), ISP, and connection type
• Threat Detection: Commercial VPN, Tor exit node, datacenter proxy flags
• Dual-Stack Support: Resolves IPv4 and IPv6, or the caller's own public IP
Cost: 1 🧩 credit ($0.001)

search_nearby_poi

Geospatial Physical Grounding

readOnlyHint

Give AI agents spatial awareness of the physical world. Search points of interest around any latitude/longitude or geohash within a radius of up to 160km:

• Planet-Scale OpenStreetMap DB: Over hundreds of millions of nodes & ways
• Expressive Filter Tags: Filter by OSM tags (e.g. amenity=hospital, cuisine=italian)
• Distance Sorting: Ascending Euclidean metric calculations with full metadata
• Agent Logistics: Essential for local errand agents, travel planners & real-estate analysis
Cost: 1 🧩 credit ($0.001)

get_balance & Safeguards

Autonomous Budgeting & Loop Guards

0 Credits · Free

Built for long-running agent autonomy and fleet orchestration without fear of budget overruns:

• Autonomous Self-Reflection: Agents query remaining credit balance before queuing large batches or external runs.
• 100% Free Tool Invocations: get_balance and tools/list consume 0 credits—never pay to check health or budget.
• Overdraft Protection: Pure prepaid balance with zero surprise overages or runaway billing loops.
• Real-Time Usage Ledger: Instant per-request accounting in Totus Console with millisecond precision.
Cost: 0 🧩 credits (Always Free)

Native Agent Tool Chaining Composable

Tools share uniform spatial representations: lookup_ip returns gh (geohash) which pipes directly into search_nearby_poi(gh=...). Agents chain localization and geospatial discovery in a single thought without fragile data conversion.

View Full Schemas →
Engineered for Scale

Mission-Critical Performance & Privacy

Built to power thousands of concurrent agent loops and production pipelines with zero compromise.

<15ms
Core Latency
Ultra-fast edge routing
99.999%
Platform Uptime
Multi-datacenter HA
0%
AI Data Training
Never retained or mined
Global
Edge & CDN
Worldwide servers for lowest latency
100%
Open RFC Specs
RFC 5322 · RFC 9728 · OAuth
High-Speed REST Core

From Agent Prototype to Production Automation

AI agents discover and experiment via MCP in their IDE or conversation loop. When it's time to automate production—scheduled background jobs, high-throughput verification pipelines, event-driven microservices, or webhook triggers—REST is the engine of execution.

Ultra-Low Latency Core

Hosted on our bare-metal multi-datacenter infrastructure. High throughput, zero noisy-neighbor delays.

HTTP Standards & Caching

Full support for ETags, gzip/brotli compression, and standard status codes. No JSON-RPC framing required.

Native Client Libraries

Official lightweight SDKs for Python, Go, Node.js, and PHP. Or call directly with any HTTP client.

OpenAPI 3.0 Specs

Strict, documented schemas ready for client generation or LLM function-calling tools.

Production REST Call
HTTP/2 GET
# Automated background or CI/CD pipeline verification:
curl -s "https://api.totus.cloud/validate/email?email=support@gototus.com&level=l5_smell" \
  -H "Authorization: Bearer TTT_YOUR_API_TOKEN"
# Real HTTP 200 OK Response (JSON):
{
  "email": "support@gototus.com",
  "result": "PASSED",
  "score": 92,
  "requested_level": "l5_smell",
  "l1": "PASSED",
  "l2": "PASSED",
  "l2_spf": true,
  "l2_dmarc": true,
  "l3": "PASSED",
  "l3_tls": true,
  "l4": "PASSED",
  "l4_temporary_email": false,
  "l4_free_email": false,
  "l5": "PASSED",
  "l5_explanation": "unknown domain but professional username and setup",
  "mail_servers": ["10 mail.kukino.uk."]
}
Install client SDK in 1 line:
pip install totus npm i totus go get github.com/GoTotus/gototus
Smart Architecture

Why Start with MCP and Scale with REST

A single unified platform that grows with your business: from interactive AI prototypes to massive production automation.

Dual Ingress · Unified Core

How Agents & Automation Share the Same Engine

Seamless transition from prompt exploration to production pipelines with zero data silos.

Door 1: Agent Layer Streamable HTTP

Interactive AI Agents

Claude Code, Cursor, Gemini, Grok, Windsurf

Protocol: Hosted MCP OAuth 2.1 Native
Door 2: Automation HTTP/2 GET

Production Pipelines

Background Jobs, Cron, CI/CD, Microservices

Protocol: Direct REST API Bearer Token

Totus Unified Core

Shared Infrastructure & Single Credit Balance

Single Wallet
$1 = 1,000 Credits
Free Discovery
0 cr for tools/list
Zero Daemons
100% Fully Hosted
Prepaid Safety
Zero Overdraft Risk

Seamless Growth

Prototype in minutes via MCP with your AI. When you graduate to scheduled pipelines, CI/CD, or microservices, call the exact same REST APIs. Zero rewrites.

Single Credit Wallet

One prepaid balance covers both interactive MCP tools and high-volume REST endpoints. Never double-pay, manage multiple plans, or get locked into subscriptions.

Zero Local Daemons

No bulky local background containers eating memory on laptops or dying mid-run. Fully hosted, remote endpoints with multi-datacenter 99.999% uptime.

Zero Overdraft Risk

Tool discovery is 100% free. Pure prepaid balance model ensures your agent or pipeline never triggers surprise overages. Track every call on your live console ledger.

Transparent Pricing

Prepaid Credits. Zero Subscriptions.

No monthly recurring fees that charge you when systems are idle. Pay only for what you execute across MCP and REST APIs.

Free Trial

No Credit Card
5,000 🧩 credits
Instant welcome bonus upon sign-in
  • Free tool discovery (0 cr for tools/list)
  • Up to ~5,000 tool or REST invocations
  • Full access across all MCP tools & REST APIs
  • Monthly refill bonus to keep prototypes alive
MOST POPULAR

Pre-Paid Credits

Pay-As-You-Go
$1 = 1,000 🧩
Minimum purchase: $5 (5,000 credits)
  • $0.001 typical cost per tool lookup
  • Credits never expire while your account is active
  • Real-time per-call ledger in Totus Console
  • No recurring subscription or lock-in

Swarms & Volume

High Throughput
Custom Tier
For multi-agent clusters & platforms
  • Volume discounts on high credit tiers
  • Post-pay invoicing & account billing
  • Elevated rate limits & dedicated capacity
  • Custom POI dataset extracts & enterprise SLA

Equip Your AI. Grow Your Business Without Limits.

From rapid agent prototyping over MCP to massive production scale over REST APIs. Start testing today.