# Aryeo MCP by usefulapi

> Aryeo MCP by usefulapi is a freemium MCP server for productivity. Hosted MCP server for managing real-estate media orders and shoots in Aryeo. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://usefulapi.io/aryeo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/aryeo
- **MCP Registry name:** io.usefulapi/aryeo
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

This hosted remote MCP server connects AI assistants to Aryeo, a platform used by real-estate photographers and media companies. It reads orders, appointments, listings, customers, products, coupons, order forms, team members and tasks.

It can also update internal order notes, reschedule or cancel appointments, create customers and create or complete tasks. When rescheduling, you choose explicitly whether Aryeo notifies the customer. No payments or refunds are exposed. You sign in with your Aryeo API key, and the server works with Claude, ChatGPT, Cursor and other MCP clients.

It suits media businesses that want to manage shoots and delivery in plain language.

## Features

- **Order review:** Find unpaid orders with customer and fulfillment details.
- **Appointment planning:** Review appointments, team calendars and open times.
- **Rescheduling:** Move or cancel appointments with an explicit notify choice.
- **Internal notes:** Replace the internal note on an order.
- **Task tracking:** List, create and complete tasks.
- **Listings and customers:** Read listings and stats, and create customers.

## Good for

- Find unpaid media orders
- Plan this week's shoots
- Reschedule an appointment after checking availability
- Update an order's internal note
- Create a task for the next delivery step

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http aryeo https://aryeo.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://aryeo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aryeo": {
      "url": "https://aryeo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aryeo": {
      "type": "http",
      "url": "https://aryeo.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aryeo": {
      "serverUrl": "https://aryeo.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aryeo": {
      "type": "http",
      "url": "https://aryeo.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `aryeo_list_orders`: List the orders of your Aryeo company (newest first by default), with payment status, fulfillment status, totals and links. Filter by search text (address or customer), payment/fulfillment status, appointment date range, tags or assigned users. GET /orders.
- `aryeo_get_order`: One order by id: customer, address, status, totals, payment and invoice links. Add include=items,appointments,listing,customer for the line items and visits. GET /orders/{id}.
- `aryeo_update_order_notes`: REPLACE the internal notes of an order (visible to your team only, not to the customer). The whole note is overwritten: read the order first and send the full new text. An empty string clears the notes. PUT /orders/{id}/notes.
- `aryeo_list_appointments`: List appointments (shoots/visits), by default the SCHEDULED ones, newest start first. Filter by upcoming/past, status, a start-time window or the assigned users. Use include=order,order.address,users to see where and who. GET /appointments.
- `aryeo_get_appointment`: One appointment by id: status, start/end, duration, assigned users and items. GET /appointments/{id}.
- `aryeo_cancel_appointment`: CANCEL an appointment. With notify=true Aryeo sends a cancellation notice to the order's customer (an email/message to a third party); with notify=false nobody is told. Cancelling can trigger fees or free the slot for other bookings. PUT /appointments/{id}/cancel.
- `aryeo_reschedule_appointment`: MOVE an appointment to a new start and end time. With notify=true Aryeo sends a reschedule notice to the order's customer (a message to a third party). Check availability first (aryeo_list_available_timeslots). PUT /appointments/{id}/reschedule.
- `aryeo_list_available_timeslots`: Bookable timeslots for ONE day (in the given timezone) for a proposed or existing appointment. Give either appointment_id, or duration + interval (minutes). Optionally restrict to users and tie it to an order. GET /scheduling/available-timeslots.
- `aryeo_list_available_dates`: Days that still have availability for a proposed or existing appointment: give a start/end range or a timeframe, plus either appointment_id or duration + interval (minutes). GET /scheduling/available-dates.
- `aryeo_list_listings`: List the property listings of your Aryeo company (address, status, price, bedrooms, delivery status, thumbnails). Filter by search text, address, listing agent, status, price/size ranges or delivery status. GET /listings.
- `aryeo_get_listing`: One listing by id: address, status, price, lot/building details, agents. Add include=images,videos,orders.appointments for media and visits. GET /listings/{id}.
- `aryeo_get_listing_stats`: Viewing statistics of a listing's property website (visits, views). GET /listings/{id}/stats.
- `aryeo_list_customers`: List your customers (the agents, brokerages and teams who order from you) with contact details and balances. Filter by name, email, email domain, phone or search text. GET /customers.
- `aryeo_create_customer`: Create a customer (an agent or brokerage that can place orders) in your Aryeo company from an owner name and email. Look the email up with aryeo_list_customers first to avoid duplicates. Aryeo may email the new customer an invitation. POST /customers.
- `aryeo_list_products`: List your services/products (main products and add-ons) with type, active state and variants. Inactive products are hidden unless include_inactive is true. GET /products.
- `aryeo_list_product_categories`: List the product categories (use the ids to filter aryeo_list_products). GET /product-categories.
- `aryeo_list_coupons`: List discount coupons (name, percent or amount off, active state, times redeemed). GET /coupons.
- `aryeo_list_order_forms`: List your order forms (the public booking forms customers use), with title, URL and scheduling settings. GET /order-forms.
- `aryeo_list_team_members`: List your company's team members (photographers and staff) with role, status, service-provider flag and permissions. Each member has two ids: the member `id` (for aryeo_list_team_member_events and as the task assignee company_team_member_id) and `company_user.id` (the USER id, for the user_ids filters of orders, appointments, timeslots and dates). company_user is included by default. GET /company-
- `aryeo_list_team_member_events`: A team member's calendar between two moments: appointments, blocks, external events and buffers. Use aryeo_list_team_members for the id. GET /company-team-members/{id}/events.
- `aryeo_list_tasks`: List tasks (to-dos such as editing or delivery steps) with assignee, due date and completion state. GET /tasks.
- `aryeo_get_task`: One task by id. GET /tasks/{id}.
- `aryeo_create_task`: Create a task, optionally with a description, due date and an assignee (a company team member id). POST /tasks.
- `aryeo_complete_task`: Mark a task completed (now, or at the given time). PUT /tasks/{id}/complete.

## FAQ

### How do I connect Aryeo?

Add the hosted server URL as a custom connector in Claude, ChatGPT, Cursor, VS Code or another MCP client. A login page then asks for your Aryeo API key.

### Can it handle payments?

No. The content says no payments or refunds are exposed.

### What does it cost?

There is a free plan with 50 tool calls per month. Paid plans cost $9/mo for 10,000 calls and $39/mo for 100,000 calls.

### Is Aryeo MCP by usefulapi free?

Aryeo MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Aryeo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http aryeo https://aryeo.usefulapi.io/mcp

### What are the best alternatives to Aryeo MCP by usefulapi?

The closest alternatives to Aryeo MCP by usefulapi are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/aryeo-mcp-by-usefulapi
