Iteration Layer
Products
Use Cases
Resources

Benchmarks

OCR
Pricing
Login Get Started
Documentation navigation

Nanobot

Nanobot is a lightweight open-source agent with chat channels, memory, MCP support, and local deployment paths. Use Iteration Layer when Nanobot needs reliable document, image, sheet, and generation tools instead of relying on model-only file reasoning.

Use this when a Nanobot agent needs to call Document Extraction, Document to Markdown, Website Extraction, Image Transformation, Image Generation, Document Generation, or Sheet Generation from an agent workflow.

Requirements

  • A Nanobot installation
  • An Iteration Layer account
  • Browser access for OAuth if you use remote MCP

Use SDK-backed custom tools or instructions first. This is the most predictable path because Iteration Layer API keys are standard bearer tokens and can be stored in Nanobot’s environment-backed configuration.

Give Nanobot this setup instruction:

Read https://iterationlayer.com/SKILL.md and use Iteration Layer APIs for document extraction, document-to-markdown conversion, website extraction, image transformation, image generation, document generation, and sheet generation.

MCP Server Endpoint

https://api.iterationlayer.com/mcp

Add Iteration Layer To Nanobot With MCP

Nanobot supports HTTP MCP servers in ~/.nanobot/config.json:

{
  "tools": {
    "mcpServers": {
      "iterationlayer": {
        "url": "https://api.iterationlayer.com/mcp",
        "toolTimeout": 180
      }
    }
  }
}

Iteration Layer MCP uses OAuth 2.1. Use this direct MCP setup only if your Nanobot version can complete OAuth for remote MCP servers. If your deployment only supports static headers for remote MCP, use SDK-backed tools instead.

Verify The Connection

Restart Nanobot or reload tool configuration, then ask the agent:

Which Iteration Layer tools can you use?

You should see tools such as:

  • convert_document_to_markdown
  • extract_document
  • extract_website
  • transform_image
  • generate_image
  • generate_document
  • generate_sheet

First Workflow

Try this with a small test file before connecting Nanobot to production channels:

Convert this supplier invoice to Markdown, extract vendor name, invoice number, due date, currency, subtotal, tax, and total, then generate a one-page approval summary.

Good Nanobot Workflows

  • Convert incoming documents from chat channels to Markdown.
  • Extract structured fields from uploaded invoices, contracts, or forms.
  • Generate spreadsheet exports from extracted fields.
  • Create PDF summaries for long-running personal or team agents.
  • Transform images before storing or forwarding them.

Production Guidance

Use Nanobot and MCP for agent-operated workflows, review queues, and internal operations. For deterministic production jobs that run on a schedule, call Iteration Layer through REST or an SDK.

The MCP and REST surfaces share the same underlying capabilities, so a workflow prototyped in Nanobot can move into production code without changing vendors.

  • Store secrets through environment-variable references instead of writing API keys directly into config files.
  • Keep tool access scoped to trusted channels and approved users.
  • Use async webhooks when the workflow can continue after Nanobot accepts a request.
  • Review EU Hosting and Data Handling & Retention for compliance-sensitive deployments.

Troubleshooting

The tools do not appear

Confirm the server URL is exactly https://api.iterationlayer.com/mcp and reload Nanobot after changing ~/.nanobot/config.json.

OAuth does not start

Use SDK-backed tools if your Nanobot version cannot complete OAuth for remote MCP servers. Iteration Layer MCP uses OAuth 2.1, not static bearer headers.

Tool calls time out

Increase toolTimeout for large files or generation-heavy workflows.