mainbook

endpoint

https://mcp.mainbook.ai/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is mainbook live?

Yes — it answered the hub's last check (checked 38m ago). It answered 100% of checks over the last 30 days.

Is mainbook free to use?

Not anonymously — it asks for a key or a login before it will serve. Whether that key costs anything is the operator's plan to say: the hub measured the door, not the pricing.

What tools does mainbook have?

4 tools: list_conversions, convert_bank_statement, get_balance, get_conversion.

Is mainbook safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• list_conversions reads auth-required 38m ago

  List one cursor page of conversion jobs visible to the MainBook account. Pass the returned next_cursor to continue.

  mcp-tool

  12345678910111213141516171819202122232425262728

  {
    "type": "object",
    "title": "list_conversionsArguments",
    "properties": {
      "limit": {
        "type": "integer",
        "title": "Limit",
        "default": 25,
        "maximum": 100,
        "minimum": 1,
        "description": "Jobs on this page, from 1 to 100."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Cursor",
        "default": null,
        "description": "Opaque next_cursor from the previous page."
      }
    }
  }

  arguments 28 lines copy
• convert_bank_statement changes data auth-required never probed

  Convert one PDF bank statement through the complete MainBook workflow: create a job, upload, start, poll, and return structured data. This creates a job and spends page credits; it is not read-only.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182

  {
    "type": "object",
    "title": "convert_bank_statementArguments",
    "properties": {
      "file_url": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "File Url",
        "default": null,
        "description": "Public HTTPS URL of a PDF for remote mode. Redirects and non-public network addresses are rejected. Exactly one source is required."
      },
      "file_path": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "File Path",
        "default": null,
        "description": "Path to a PDF on the MCP server machine. This field is only available over stdio and is rejected in HTTP mode; remote clients must use file_url. The path must be inside the allowed folders, which default to Downloads, Desktop, and Documents. Exactly one of file_path and file_url is required."
      },
      "output_path": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Output Path",
        "default": null,
        "description": "Optional absolute result file or existing folder on the MCP server machine. Only available over stdio and only inside the allowed folders. The file extension is corrected to match result_type."
      },
      "result_type": {
        "enum": [
          "json",
          "xlsx",
          "csv"
        ],
        "type": "string",
        "title": "Result Type",
        "default": "json",
        "description": "JSON is returned inline. Over stdio, XLSX or CSV is written to an allowed local folder and the full path is returned. HTTP mode returns safe download instructions. Binary bytes never enter model context."
      },
      "idempotency_key": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Idempotency Key",
        "default": null,
        "description": "Optional value forwarded verbatim in the Idempotency-Key REST header."
      },
      "timeout_seconds": {
        "type": "integer",
        "title": "Timeout Seconds",
        "default": 50,
        "maximum": 900,
        "minimum": 30,
        "description": "Internal polling budget from 30 to 900 seconds. Timeout leaves the job running and returns its job_id for get_conversion. The default stays under the 60-second request timeout most MCP clients enforce; a client that gives up first discards the job_id and the conversion looks lost."
      }
    }
  }

  arguments 82 lines copy
• get_balance reads auth-required 38m ago

  Return total, reserved, and available MainBook credits. Every value is measured in PDF pages.

  mcp-tool

  12345

  {
    "type": "object",
    "title": "get_balanceArguments",
    "properties": {}
  }

  arguments 5 lines copy
• get_conversion reads auth-required 38m ago

  Get the current state of one MainBook conversion. When successful, return JSON inline or save XLSX/CSV locally over stdio. HTTP mode returns safe download instructions. Use this after convert_bank_statement times out.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "title": "get_conversionArguments",
    "required": [
      "job_id"
    ],
    "properties": {
      "job_id": {
        "type": "string",
        "title": "Job Id",
        "minLength": 1,
        "description": "Conversion job UUID returned by MainBook."
      },
      "output_path": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Output Path",
        "default": null,
        "description": "Optional absolute result file or existing folder on the MCP server machine. Only available over stdio and only inside the allowed folders."
      },
      "result_type": {
        "enum": [
          "json",
          "xlsx",
          "csv"
        ],
        "type": "string",
        "title": "Result Type",
        "default": "json",
        "description": "Result representation to retrieve after the job succeeds."
      }
    }
  }

  arguments 40 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.