mcpField
A
API

API

Local
github.com/spprichardDeveloper Tools0Updated 80w ago
Repository

About API

API is a collection of Swift projects for personal tasks, with MCP and REST interfaces planned for clients and automation. Its current MCP capability searches a provided mailbox for unread email; OCR and attachment processing are described as future work.

Key features

  1. 01Search a mailbox for unread email
  2. 02REST API for email search
  3. 03Separate OCR server and client
  4. 04Mistral-backed OCR endpoint

Use cases

  1. 01Find unread messages in a mailbox
  2. 02Search email through the REST API
  3. 03Run OCR on an email using search criteria

MCP support

The MCP server currently exposes unread-email search for a provided mailbox. Listing email details and further attachment and OCR workflows are listed as next steps.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

API

Currently I am thinking this project will be similar to API.me... 1 difference is that this project will have an MCP API & a REST API. The MCP interface will be used for clients like Claude, OpenAI, etc. Where as the REST API could be leveraged for other reporting tasks or other automation tasks

Project

Current State:

  • MCP Server

    • Can search for unread emails in provided mailbox Search For Unread Emails

  • Email Server

    • Can complete basic searches for a provided mailbox
Project Next Steps
  1. Gather PDF attachments
  2. Add OCR capability
    • Start with Mistral OCR API?
  3. Upon completion of 1 & 2, add ability to fetch email with attachment & perform OCR, returning structured output

REST API

Email
Current State:
  • Can search for unread emails in provided mailbox
  • Updated to version of SwiftMail which handles email header & body differently
Next:
OCR
Current State:
  • Created new OCR server & client, uses Mistral under the hood
  • Created new endpoint for performing OCR on an email, providing correct email search criteria
Next:
  • Get MCP server running again, such that we can list email details. Then find the uID, sequenceNumber, section for a valid email to perform OCR on

MCP API

Current State:
  • Can search for unread emails in provided mailbox
Next:
  • Explore how we could use Templated Resources
    • Could leverage Email API?

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.