[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Aspire API and MCP server: Let your AI agent run the office side of every crew.

> Aspire has an External API, but not for everyone by default: Enterprise includes it, Growth and Corporate request activation from AspireCare at no extra cost. Only an Aspire Admin can create the client ID and key. No Aspire MCP server and no official ChatGPT or Claude connector was found.

Aspire's External API is included on Enterprise and activated on request for Growth and Corporate, and Aspire has no MCP server (checked 16 Nov 2026). Cotlet runs a hosted Aspire MCP server with 10 tools that ChatGPT and Claude use in your own Aspire login, on any tier. Proposals, invoices, orders and campaigns wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Aspire
- Page: https://cotlet.dev/integrations/aspire-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Aspire. Aspire is a trademark of its owner. If Aspire's own integrations cover what you need, use them first.

## What can your AI agent do in Aspire?

- Put unscheduled tickets on the board
- Price an enhancement and send the proposal
- Chase overdue invoices by branch
- Order materials for won jobs
- Find jobs running over their hours
- Build a renewal or upsell campaign

## Does Aspire have an MCP server or an API?

- The API runs on OData queries at cloud-api.youraspire.com, with a sandbox at cloudsandbox-api.youraspire.com.
- Its guide lists endpoints for opportunities, contacts, properties, work tickets, invoices, receipts, vendors and equipment.
- No report endpoints and no Marketing Pro endpoints appear in the guide index.

| What you need | Aspire API | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No MCP server found | Copy and paste | Hosted MCP server |
| Start on any Aspire tier, as any user | Enterprise, or activation; Admin keys | Your login | Your login, once |
| Tickets, invoices, purchasing, equipment | Endpoints in the guide | One screen at a time | 10 tools, writes after your OK |
| P&L reports and Marketing Pro campaigns | Not in the guide index | In the app | Same tools |

Checked 16 Nov 2026. Sources: [Aspire API quick start](https://guide.youraspire.com/apidocs/quick-start), [Aspire guide index (llms.txt)](https://guide.youraspire.com/llms.txt), [Aspire CRM](https://www.youraspire.com/features/crm), [Aspire estimating](https://www.youraspire.com/features/estimating), [Aspire invoicing](https://www.youraspire.com/features/invoicing), [Aspire job costing](https://www.youraspire.com/features/job-costing), [Aspire purchasing](https://www.youraspire.com/features/purchasing), [Aspire reporting](https://www.youraspire.com/features/reporting), [Aspire scheduling](https://www.youraspire.com/features/scheduling), [Aspire equipment](https://www.youraspire.com/features/equipment), [Aspire cost accounting](https://www.youraspire.com/features/accounting), [Aspire Marketing Pro](https://www.youraspire.com/products/aspire-marketing-pro)

## How does the Aspire MCP server work?

1. **Sign in to Aspire.** Once, with your company code, in a browser we host.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the board.** It lines up tickets; you approve the moves.

Your agent works in your own signed-in Cloud Browser. Board moves, proposals, invoices, orders and campaigns wait for your OK.

## How to connect Aspire to your AI agent

1. **Sign in to Aspire in a Cloud Browser.** Open app.youraspire.com in your Cotlet Cloud Browser and sign in with your email, password and company code.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Aspire uses the shared address `https://cotlet.dev/mcp/v1`, the same one as every other app you turn on, so the office needs a single connector. Switched Aspire on after connecting? Refresh the connector and the 10 Aspire tools load.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: aspire_read
```

## All 10 Aspire MCP tools

One tool per Aspire feature area. The write tools take an `action`: `list`, `get` and `needs` only read, the other actions change Aspire and ask first.

### Sales: opportunities and estimates

The pipeline by status or rep, then estimates from your catalog, templates and kits with your markups. Sending a proposal is its own call.

- **Manage sales opportunities** (`manage_opportunities`, write, asks first): List, read, add or update opportunities in Aspire's CRM pipeline.
- **Create estimates and proposals** (`create_estimates`, write, asks first): Build an estimate from your catalog, templates and kits, or send the proposal for signature.

### Operations: schedule and equipment

Work tickets on the schedule board, unscheduled tickets, and the readings that trigger equipment maintenance.

- **Manage job schedule** (`manage_schedule`, write, asks first): Read the schedule board and unscheduled tickets, or schedule, move, split or reassign a work ticket.
- **Manage equipment** (`manage_equipment`, write, asks first): List vehicles and equipment, log hours or miles, or record a service.

### Money: purchasing and invoicing

Materials won jobs need, purchase orders to vendors, and invoices from ready to overdue. Orders and sends wait for your OK.

- **Create purchase orders** (`manage_purchase_orders`, write, asks first): See the materials won jobs need, compare vendor prices and submit a purchase order.
- **Create invoices** (`manage_invoices`, write, asks first): List invoices that are ready, sent or overdue, generate them, or send them to the customer portal.

### Numbers: job costing, reports and accounting

Estimated against actual costs, P&L down to the gross margin line, and the month-end data Aspire hands to accounting. Read only.

- **View job costing** (`view_job_costing`, read): Compare estimated with actual labor, material and other direct costs for a job or work ticket.
- **View business reports** (`view_business_reports`, read): Read Aspire's profit and loss and other reports, filtered down to the gross margin line.
- **View cost accounting data** (`view_cost_accounting`, read): Read the month-end P&L per division and the data Aspire sends to your accounting and payroll.

### Marketing Pro campaigns

Email, direct mail or SMS to segments built from Aspire data. Needs Marketing Pro on your account.

- **Create email and direct mail campaigns** (`create_marketing_campaigns`, write, asks first): Build a targeted email, direct mail or SMS campaign in Aspire Marketing Pro from your Aspire customer data.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/aspire-api-mcp-server#tools

## Who can see my Aspire session, and how do I revoke it?

- **What we store.** Your signed-in Aspire browser profile, AES-256-GCM encrypted, in Finland. Never your password or company code.
- **What your agent gets.** The 10 Aspire tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The branches, properties and money your Aspire user and role can open, and nothing more.
- **What no tool touches.** Users, roles, API credentials, your accounting and payroll connections, and company settings.
- **If Aspire signs you out.** You sign in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Aspire for agents, reset the browser, or change your Aspire password.

You type your Aspire password and company code yourself; the agent only uses the session that sign-in leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Read what jobs need.** manage_purchase_orders with `needs`.
2. **Group by vendor.** One draft order per vendor, net of inventory.
3. **Show you the lines.** Items, quantities, prices and the total.
4. **Submit after your OK.** The order goes to the vendor.

| Action | How to put it right |
|---|---|
| Ticket moved or reassigned | Call manage_schedule again with the earlier date or crew |
| Opportunity field or status | Update it back with manage_opportunities |
| Equipment reading typed wrong | Log the correct reading with manage_equipment |
| Proposal, invoice, order or campaign sent | Already with the customer or vendor: contact them directly |

All 7 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 3 read tools, job costing, reports and cost accounting, run at once.

MCP call:

```
{
  "name": "manage_purchase_orders",
  "arguments": {
    "action": "create",
    "vendor": "Example Nursery Supply",
    "lines": [
      {
        "item": "Hardwood mulch",
        "quantity": 40,
        "unit": "cu yd",
        "price": 32
      },
      {
        "item": "Annual color, 4 in pots",
        "quantity": 600,
        "unit": "each",
        "price": 2.1
      }
    ]
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/aspire/purchase-orders/manage \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"create","vendor":"Example Nursery Supply","lines":[{"item":"Hardwood mulch","quantity":40,"unit":"cu yd","price":32},{"item":"Annual color, 4 in pots","quantity":600,"unit":"each","price":2.1}]}'
```

Response:

```
{
  "vendor": "Example Nursery Supply",
  "lines": [
    {
      "item": "Hardwood mulch",
      "quantity": 40,
      "unit": "cu yd",
      "price": 32
    },
    {
      "item": "Annual color, 4 in pots",
      "quantity": 600,
      "unit": "each",
      "price": 2.1
    }
  ],
  "total": 2540,
  "submitted": true
}
```

The example orders 40 cubic yards of mulch at $32 and 600 annuals at $2.10 from one nursery: $2,540 in all. A cron job or n8n flow can make the same call over REST at `/api/v1/aspire` with the same key and price, in JSON. Failed calls are free.

## How much does the Aspire MCP server cost?

**About $22 a month** for a landscape company with four crews, 3,780 credits. Your Aspire subscription stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Schedule board and ticket moves | 4 × 22 | 880 |
| Pipeline updates | 2 × 22 | 440 |
| Estimates and proposals | 2 × 12 | 240 |
| Overdue and ready invoices | 2 × 4 | 80 |
| Materials and purchase orders | 3 × 4 | 120 |
| Job costing and P&L review | 3 × 4 | 120 |
| Truck and equipment readings | 10 × 4 | 400 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 228 calls | 3,780 |

The smallest pack, 5,000 credits for $29, covers this month. More crews and branches mean more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Works on your Aspire tier as it is

Credit packs are one-time purchases, not a subscription. The month above comes from our own assumptions, not measured customer usage.

## Aspire MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Aspire External API | OData endpoints for opportunities, work tickets, invoices, receipts, equipment and more. | Enterprise, or activation through AspireCare; an Admin makes the keys; you write and host the client. |
| Aspire's accounting and payroll integrations | Send vendor invoices, AR deposits, month-end P&L and the payroll file. | Built for your books, not a route for an AI agent. |
| Aspire Marketing Pro | Campaigns built on Aspire customer and property data. | Runs inside Marketing Pro; your agent cannot drive it on its own. |
| By hand | Open the board, invoicing and purchasing in Aspire and click through. | One screen at a time, only while someone is in the office. |

If you are on Enterprise or have the API activated and have a developer, the Aspire API is the vendor's own route: use it for bulk syncs. Cotlet fits when you want ChatGPT, Claude or a script working in Aspire today, from your own login, with nothing to build or host.

## Who runs Cotlet

Cotlet.dev belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and trading since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Send questions about the Aspire tools to contact@cotlet.dev.

## Aspire MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=aspire, turn on Aspire under Integrations in the console and sign in at https://app.youraspire.com/ in your Cloud Browser with your email, password and company code. Then connect your AI agent and ask it to read the board. The trial needs no card.

### Does Aspire have an API?

Yes, gated: Aspire has an External API at cloud-api.youraspire.com. It is included on the Enterprise tier; Growth and Corporate companies request activation from AspireCare at no extra cost, and only an Admin user can create the client ID and key (Aspire API guide, checked 16 Nov 2026). No Aspire MCP server and no official ChatGPT or Claude connector was found. Cotlet does not use that API: it works in your own signed-in Aspire account, on any tier.

### Do I need Aspire Marketing Pro for campaigns?

Yes. create_marketing_campaigns works only where Marketing Pro is on your Aspire account. The other tools work with Aspire itself.

### Does Cotlet post to my accounting system or run payroll?

No. Aspire sends vendor invoices, AR deposits, month-end P&L and the weekly payroll file through its own integrations. view_cost_accounting only reads that data.

### Which Aspire user should I sign in with?

The user whose work the agent should do. It sees only what that user's role sees, so an office manager without P&L access gives the agent no P&L either. You do not need an Admin user.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 10 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Aspire?

No. Cotlet is independent and not affiliated with Aspire.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
