Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encrata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

auth.md provides a standardized path for agents to register for services on behalf of users. It provides a simple, discoverable authentication contract that any AI agent can follow. At its core, auth.md is a small Markdown file hosted at https://encrata.com/auth.md. The file describes how agents authenticate with Encrata, which endpoints are available, what scopes they can access, and what to do once authenticated. Because Markdown is plain text, the same file works as documentation for human integrators and as a discoverable runtime artifact for agents.

​
How it works

There are two primary paths for how an agent can authenticate with Encrata:

API Key Flow

Agent authenticates via email/password, creates an API key, and operates autonomously.

MCP Flow

Agent connects via Model Context Protocol. Every lookup becomes a tool call.

​
The contract

The auth.md file at encrata.com/auth.md tells agents everything they need:
  1. How to authenticate - login endpoint, request format, expected responses
  2. How to get an API key - programmatic key creation for long-lived access
  3. What endpoints exist - every lookup type with parameters and response shapes
  4. How credits work - cost per lookup, balance checking
  5. MCP configuration - server URL and tool names for MCP-capable agents
  6. Error handling - status codes, rate limits, retry behavior

​
Why auth.md?

Traditional API authentication requires developers to read docs, sign up manually, copy keys from dashboards, and configure their applications. AI agents can’t do any of that. auth.md solves this by making authentication machine-discoverable:
  • No GUI required - agents authenticate programmatically end-to-end
  • Self-describing - the file contains everything needed, no external docs required
  • Standard format - plain Markdown that any agent can parse
  • Always current - hosted at a well-known URL, always reflects the latest API

​
Integration guides

For AI Agents

How agents discover and use Encrata’s auth.md to authenticate and operate.

For Developers

How to point your agent at Encrata’s auth.md and configure access.