Skip to content

Marketing Automation

Perkville MCP connector

The Perkville connector brings members, point balances, level progress, challenges, locations, and staff into Claude, ChatGPT, Cursor, and the Elaichi Agent, so each person can look up and update loyalty records inside their own Perkville access.

  • How it connects. Connects over OAuth. The credential goes into a vault nobody reads back.

  • One address. https://api.elaichi.ai/mcp, the same for every user.

  • Their own access. An agent never gets more than the person it acts for.

How to connect

How to connect Perkville to Claude, ChatGPT or Cursor

Two steps, about a minute.

1

In Elaichi

Connect Perkville once

  1. Open Connections, choose Add connection, and pick Perkville.

  2. Optionally set Share with to give a team access, then press Connect.

  3. Supply your own Perkville app, then approve. Perkville needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

The credential is vaulted. Nobody reads it back, not even the AI.

Add connection

Choose a connector.

perkville
Perkville
Beamer
Buffer
ClickSend
Dotdigital
Dub
2

In your AI client

Point it at one endpoint

Everyone in the organization uses the same address, and each person only ever reaches what their own account allows.

Connect Perkville to Claude

  1. 1

    Open Customize, then Connectors.

  2. 2

    Press Add.

  3. 3

    Name it, paste the MCP server URL, then Continue.

    https://api.elaichi.ai/mcp
  4. 4

    Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

Connect Perkville to ChatGPT

  1. 1

    Open Plugins, then press the + button.

  2. 2

    Name it and paste the endpoint into Server URL.

    https://api.elaichi.ai/mcp
  3. 3

    Leave Authentication on OAuth, then tick the risk acknowledgement.

  4. 4

    Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

Connect Perkville to Cursor

  1. 1

    Open ~/.cursor/mcp.json.

  2. 2

    Add the endpoint under mcpServers.

    https://api.elaichi.ai/mcp
  3. 3

    Reload Cursor, then sign in and approve.

~/.cursor/mcp.json

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

Set up per machine, so repeat it on each computer you work from.

Connect Perkville to any MCP client

  1. 1

    Add the endpoint as a remote MCP server.

    https://api.elaichi.ai/mcp
  2. 2

    Sign in and approve.

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

The Elaichi Agent already has these tools, with nothing to set up.

Use cases

What teams do with Perkville through Elaichi

Every one of these runs inside the access the person already has, and lands in the same audit log.

  • Front desk

    Answer a balance question at the counter

    A member asks how many points they have and how close they are to the next level. Ask for the answer by name and get their balance and level progress from Perkville without leaving the conversation.

  • Marketing

    See which challenges are actually landing

    Pull the list of live challenges, their requirements, and how many members have joined each one, then decide which to promote next month.

  • Membership

    Enroll a new member into rewards

    After someone signs up at a location, create their Perkville connection and set the attributes the team tracks, so they start earning from day one.

  • Retention

    Find members stalled below the next level

    Ask for members whose level progress has not moved, and hand the list to whoever runs win-back outreach.

  • Operations

    Check staff across every location

    List the businesses in your Perkville account and the staff attached to each, and spot where a location is missing someone or lists a person who has moved on.

  • Support

    Fix a member record after a call

    A member says their details are wrong. Look up their connection, update it, and confirm the current agreement version they accepted, all in one exchange.

Try asking

  • “Which Perkville challenges have unmet requirements this month?”
  • “List Perkville businesses with the most challenge connections.”
  • “Summarize staff activity across our Perkville challenges this week.”

See all 85 Perkville tools below

AI tools

Perkville tools for your AI agents

85 tools are ready to call through Elaichi's MCP endpoint the moment you connect Perkville, governed by the same roles, restrictions, and audit log as everything else in Elaichi.

See it in Elaichi

What connecting Perkville gets you

6 screens from the product, each doing one job for your Perkville account.

The agent

Ask about challenges, get real answers.

Plain language questions run against live Perkville challenges, businesses and staff records.

  • challenges
  • businesses
  • staff
  • challenge requirements

Ask Elaichi to work across your apps.

Which Perkville challenges have unmet requirements this month?

List Perkville businesses with the most challenge connections.

Summarize staff activity across our Perkville challenges this week.

Also runs in Claude, ChatGPT or Cursor

MCP clients

Claude, ChatGPT and Cursor reach Perkville.

One org-wide MCP endpoint over OAuth, no SDK and no shared API key.

ElaichiMCP clients
Claude ChatGPT Cursor

Copy the endpoint

https://api.elaichi.ai/mcp
Client Connected by Status Last used
Claude
E

Emma Laurent

• Connected 4 minutes ago
Cursor
S

Sofia Ricci

• Connected 2 hours ago
ChatGPT
C

Clara Nowak

• Connected Yesterday

Tool catalog

85 Perkville tools ready to call.

Businesses, staff, challenges, requirements and agreement versions covered without custom code.

  • List all Perkville agreement versions
  • Get single Perkville agreement version by ID
  • List all Perkville businesses
  • Get single Perkville business by ID
ElaichiTools
Tool Action Description
List all Perkville agreement versions List List Perkville agreement versions for a business or agreement. Returns: agreement_version_id, agreement_id, agreement_internal_name, agreement_type, apply_to_join_flow, business, version, text, is_active, created_dt, last_mod_dt, resource_uri. At least one of the agreement or business filter is required; business__in queries are not supported.
Get single Perkville agreement version by ID Get Get a single Perkville agreement version by id. Returns: agreement_version_id, agreement_id, agreement_internal_name, agreement_type, apply_to_join_flow, business, version, text, is_active, created_dt, last_mod_dt, resource_uri, address_1, address_2, city, country_code, external_location_id, latitude, location_id, longitude, name, postal_code, state. Required: id.
List all Perkville businesses List List Perkville businesses, each representing a single rewards program for a real-world business. Returns: business_id, categories, fine_print, homepage_url, locations, name, logo_url, brand_color, brand_secondary_color, promotions, perks, perkville_url, resource_uri, rewards_program_name, app_connection_message, loyalty_launch_dt, prelaunch_info_message, allow_referrals_before_start_dt,…
Get single Perkville business by ID Get Get a single Perkville business by id. Returns the full business object including business_id, name, rewards_program_name, categories, locations, promotions, perks, homepage_url, resource_uri, fine_print, brand_color, brand_secondary_color, logo_url, perkville_url, app_connection_message, loyalty_launch_dt, prelaunch_info_message, allow_referrals_before_start_dt,…
List all Perkville staff List List business staff members in Perkville. Results are filtered to only return staff at businesses where the token owner is also a staff member. Returns: staff_id, business, created, bill_payer, resource_uri, staff_role, staff_description, user. Filterable by business, bill_payer, staff_role, and user.

Toolboxes

Every team gets its own toolbox.

Scope Perkville challenge tools to marketing while support keeps a narrower toolbox.

  • Marketing
  • Customer success
  • Operations
  • Legal
ElaichiToolboxes
Name Source template Tools Created

Marketing toolbox

Perkville · challenges and requirements

Perkville starter 18 Mar 4, 2026

Customer success toolbox

Perkville · challenge connections

9 Mar 2, 2026

Operations toolbox

Perkville · businesses and staff

24 Feb 27, 2026

Legal toolbox

Perkville · agreement versions

Perkville starter 6 Feb 19, 2026

Support toolbox

Perkville · member challenge lookups

31 Jan 30, 2026

Analytics toolbox

Perkville · requirement summaries

12 Jan 22, 2026

Shared connections

Teammates use Perkville without a credential.

See who connected each account and how many teams and members share it.

  • Marketing
  • Studios North
  • Franchise HQ
  • Customer success
ElaichiConnections
Connection Scope Status Access
PE

Perkville (Marketing)

Connected by Emma Laurent

Personal • Active 1 team · 6 members
PE

Perkville (Studios North)

Connected by James Whitfield

Organization • Active 3 teams · 24 members
PE

Perkville (Franchise HQ)

Connected by Sofia Ricci

Organization • Active 2 teams · 11 members
PE

Perkville (Customer success)

Connected by Daniel Ortega

Personal • Needs re-auth 1 team · 3 members
PE

Perkville (Support)

Connected by Clara Nowak

Personal • Active Not shared
PE

Perkville (Legal review)

Connected by Michael Brennan

Personal • Active 2 teams · 9 members

Audit log

Every Perkville call has a name on it.

When, who, what happened, type and resource, appended for each challenge and staff lookup.

  • When
  • Who
  • What happened
  • Type
ElaichiAudit log
When Who What happened Type

2 minutes ago

Mar 6, 2026, 3:10 PM

E

Emma Laurent

[email protected]

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

James Whitfield

[email protected]

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

S

Sofia Ricci

[email protected]

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

D

Daniel Ortega

[email protected]

Perkville Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

C

Clara Nowak

[email protected]

Perkville Challenges Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

M

Michael Brennan

[email protected]

Perkville Challenges List Toolbox

Launching soon

From answering questions to doing the work

A person no longer has to ask. A trigger starts the work, inside the same permissions and the same audit log as everything else. Automations and live dashboards are launching soon, on the Black plan.

Automations

A schedule drafts your challenge digest.

Perkville challenges are fetched, grouped, drafted by an agent, approved, then posted back.

Perkville digest

Run 418 · started 2 minutes ago · on behalf of Emma Laurent

  1. Schedule

    Every weekday at 08:00

    0.2s
  2. Fetch challenges

    Perkville

    1.4s
  3. Group by owner

    Transform

    0.1s
  4. Draft the digest

    Agent step

    Ran with 4 tools, returned a structured summary

    6.2s
  5. Approve the digest

    Needs approval

    Assigned to Michael Brennan

    Approve
  6. Post the digest

    Perkville

    Queued

Collections and dashboards

Perkville health, counted not guessed.

Four metrics, 14 days of challenge connections and a team breakdown, refreshed on schedule.

Perkville health

Refreshed 4 minutes ago · every 15 minutes · from the challenges collection

Live

Challenges

1,284 ↓ 12%

Businesses

96 ↓ 8%

Needs attention

3 ↑ 2

Updated this week

412 ↑ 9%

Challenges created

Last 14 days

By team

Share of activity

Marketing 34%

Studios North 27%

Franchise HQ 21%

Customer success 18%

FAQ

Frequently asked questions

How do I connect Perkville to Claude?

Connect Perkville in Elaichi first, then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Perkville connects over OAuth, but it asks you to register an OAuth application inside Perkville yourself, so one person brings a client ID and secret to Elaichi once and nobody else ever handles them. After that, each person signs in to Perkville in their browser when Claude first asks.

Does Perkville work with ChatGPT and Cursor as well as Claude?

Yes. Once Perkville is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client, and the Elaichi Agent. You connect Perkville once and every client sees it.

What can an AI agent actually do with my Perkville data?

It can look up members and their point balances, check level progress, list challenges and their requirements, see who has joined a challenge, and pull your locations, staff, and agreement versions from Perkville. It can also enroll a member by creating a connection and update an existing one. Perkville exposes many actions, so short, specific asks such as "show Maria's point balance" work better than long sentences.

Does connecting Perkville give the AI everything in my account?

No. Every request runs as the person who signed in to Perkville, so the AI sees only the locations, members, and staff that person can already see. Elaichi can narrow that further with restrictions per action, and it can never grant more than Perkville itself allows.

Can my team share one Perkville connection?

Yes. One person connects Perkville in Elaichi and shares it with a team, and nobody else touches the client ID, secret, or any credential. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every lookup or update in Perkville.

Can I stop an agent from deleting or changing things in Perkville?

Yes. In Elaichi you can block specific Perkville actions, such as creating or updating a member connection, while leaving lookups open. A blocked action is never shown to Claude, ChatGPT, or Cursor at all, so no prompt, however worded, can reach it.

What happens to a Perkville connection when someone leaves?

Offboard them in Elaichi and their access to Perkville through every client ends at once. A shared Perkville connection keeps working for everyone else on the team. If you ever want Perkville gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor, and the Elaichi Agent together.

Put Perkville in front of your team

Fourteen days on Gold, no credit card. Connect it once and pick what each team can call.