Aucterra MCP Server
An MCP-compatible server that enables LLM agents to interact with Aucterra's document understanding APIs, providing structured access to document classification and field extraction services.
README Documentation
Aucterra MCP Server
This repository configures an MCP-compatible server for Aucterra's Document Understanding APIs using the aucterra-mcp package.
It enables LLM agents to interact with Aucterra's document classification, extraction, etc. services using Google's Agent Development Kit (ADK).
🔧 Configuration
Include this block in your mcpServers configuration (e.g., config.json or mcp.yaml):
{
"mcpServers": {
"aucterra": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/japisuru/aucterra-mcp",
"aucterra-mcp"
],
"env": {
"AUCTERRA_API_KEY": "your_api_key_here"
}
}
}
}
🔐 Required Environment Variables
| Variable | Description |
|---|---|
AUCTERRA_API_KEY | Your API key for accessing Aucterra's services |
⚙️ Tool Behavior
This MCP tool provides structured access to Aucterra's:
- 📁 Document Classification
- 🗂️ Key-Value Field Extraction (Simple + List fields)
The tool accepts pdf or image files and returns structured JSON output.
✅ Agent Integration (Google ADK)
To use this tool within your LlmAgent, configure it as follows:
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset, StdioServerParameters
aucterra_tool = MCPToolset(
connection_params=StdioServerParameters(
command="pipx",
args=[
"run",
"--spec",
"git+https://github.com/japisuru/aucterra-mcp",
"aucterra-mcp"
],
env={"AUCTERRA_API_KEY": "your_api_key_here"}
)
)
Add this tool to your agent via tools=[aucterra_tool].
📚 Example Use Cases
User: Classify this document (/path/to/the/document/doc.pdf) into invoice or identity document.
User: Extract the following fields: NIC, Full Name, Date of Birth from this document (/path/to/the/document/doc.pdf)
User: Extract Tax ID as 'Tax Identification Number' from this document (/path/to/the/document/doc.pdf).
The agent will use the Aucterra MCP server to extract fields, filling in missing values (e.g., using the same value for field_key and field_name if only one is provided).
📦 Dependencies
Ensure pipx is installed and available on your system.
Install it via:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
🛠️ Issues
If you encounter issues, ensure your API key is correct and the tool is up to date:
pipx upgrade aucterra-mcp