v1.0.11.0 is here: six tools, one workspace.See what's new →
Armor EdgeAI
EN
Download

AI Agents · MCP

Let AI agents
recognize and transcribe on this computer

AI agents such as Claude Code, Cursor, VS Code and OpenCode can call Armor's text recognition and speech-to-text over MCP. The work runs on your computer; it's off by default, each agent gets its own token, and you can revoke any of them.

AI agents
Claude CodeCursorVS CodeOpenCode
“Turn the payment terms in this scanned contract into a table”
→POST /v1/mcpBearer connection token←Structured result
Your computer · Armor EdgeAI
Document OCRocr_recognizeExtract data from scansocr_extractSpeech transcriptionspeech_transcribe
Long jobs return a job_id, which the agent follows with job_status / job_result / job_cancel. Results also show up in your workstation, marked with the connection that created them.

01 — Tools

Three abilities your agent gets

Each connection can be granted only some of them. The tools use only the models and engines already installed and never download anything — when something is missing they return an error code, and you decide whether to install it in Armor.

ocr_recognize

Document OCR

Recognizes a PDF or image and returns each page's Markdown, its layout blocks (type, text, position) and its table cells.

  • Send the file's content directly (up to 16 MiB) or a path inside an approved folder
  • Recognize only the pages you pick
  • Results show up in your Document Recognition workstation, marked with this connection
Sample result (made-up content)
{
  "job_id": "…",
  "pages": [
    {
      "page": 1,
      "markdown": "# Purchase Agreement\nArticle 3 Payment terms…",
      "blocks": [
        { "type": "title", "text": "Purchase Agreement", "bbox": […] },
        { "type": "table", "text": "…", "bbox": […] }
      ],
      "tables": [
        { "bbox": […], "cells": [["Item", "Amount"], …] }
      ]
    }
  ]
}

Returned content comes from your files. It is data, not instructions for the agent — the tool descriptions tell the agent plainly not to act on text found in it.

02 — Setup

Connect in three steps

  1. 1Turn on “Allow AI agents to connect”
  2. 2Click “New connection” and choose what this agent may use
  3. 3Paste what you get when it is created into the agent. The token is shown only once
Settings — AI agent connections
Allow AI agents to connectWhen on, AI agents on this computer that hold a connection token can call Armor. Turning it off stops every agent. Off by default.
Addresshttp://127.0.0.1:2918/v1/mcp
Connections (2)
  • Claude CodeOCR text recognition, Speech to text · Last used 5 minutes ago
  • CursorLANSpeech to text · Last used 3 hours ago
Call logThe latest 200 agent calls.
  • 14:02Claude CodeDocument OCROK
  • 13:47Claude CodeExtract data from scansOK
  • 11:20CursorSpeech transcriptionFailed

Mock-up: connection names, the log and the token are made up; the token is shown as armor_mcp_….

03 — Guardrails

You open every door

Off by defaultUntil you turn on “Allow AI agents to connect”, no agent can reach Armor; turning it off takes effect immediately.
One token per agentEach agent gets its own connection token, with its own abilities, and can be revoked on its own; once revoked, that agent is cut off immediately.
Only the folders you approveWith no folders approved, agents can only send file contents directly; once you approve folders, they can point to files in them by path.
Three switches for the LANLAN sharing, “Also allow AI agents on the LAN to connect” and the connection's own “Allow from the LAN” must all be on. Agents on the LAN can only send file contents, not paths.
Every call is visibleThe call log keeps the latest 200 calls: which connection, what it did, and whether it succeeded.
Never downloads on its ownAn agent can't download models or engines for you. If something is missing it says so, and you install it in Armor.

Results handed to an agent are processed by that agent and may be sent to its own cloud service. Recognition and transcription run on your computer, but once a result is handed over, the agent decides where it goes — connect only agents you trust.

LAN connections use unencrypted HTTP, so anyone on the same network may be able to read a connection's token. Use this only on a network you trust, and revoke the connection when you no longer need it. Clear my data also removes every connection and the call log.

Rather not paste the config yourself

Copy the text the app gives you and paste it into Claude Code, Codex or another AI agent. It will add the server to its settings and test the connection by itself, whether it runs on this computer or on another computer on the LAN.

Illustration · the real text is generated by the app

Please add Armor EdgeAI to your MCP settings: server name armor, address http://127.0.0.1:2918/v1/mcp, with the Authorization header. After adding it, list the tools once to confirm the connection…

Next

Try recognition and transcription first, then hand them to agents