Skip to content

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
Attentive
Beamer
beehiiv
Bird
Buffer
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.

Perkville MCP connector for 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.

Perkville MCP connector for 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.

Perkville MCP connector for 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

Compare

Elaichi vs Zapier MCP vs Composio for Perkville

All three can connect Perkville to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

Elaichi compared with Zapier MCP and Composio for Perkville, by what to check
What to check Elaichi Zapier MCP Composio
Where the AI connects One address for the whole organization. https://api.elaichi.ai/mcp A server per member, created at sign-in. An MCP endpoint per team, or an SDK.
Control over Perkville tools Allow or restrict single Perkville tools, per role or user. App and action restrictions on the account. Role permissions, down to the action.
Record of calls One audit entry per Perkville call. A History tab of tool calls. A log of every tool call.
Single sign-on SAML or OIDC, plus SCIM, on Gold. SAML on Enterprise. SAML and OIDC on Enterprise.
Price $15 per user per month. 2 tasks per successful call. Billed per tool call.

Sources: Zapier MCP docs, security, usage; Composio docs, gateway, enterprise, pricing. Checked September 2026.

Longer take: Zapier MCP alternative and when you don't need an MCP gateway.

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

Emily Carter

• Connected 4 minutes ago
Cursor
M

Megan Brooks

• Connected 2 hours ago
ChatGPT
R

Ryan Hayes

• 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 Emily Carter

Personal • Active 1 team · 6 members
PE

Perkville (Studios North)

Connected by Jake Morgan

Organization • Active 3 teams · 24 members
PE

Perkville (Franchise HQ)

Connected by Megan Brooks

Organization • Active 2 teams · 11 members
PE

Perkville (Customer success)

Connected by Tyler Reed

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

Perkville (Support)

Connected by Ryan Hayes

Personal • Active Not shared
PE

Perkville (Legal review)

Connected by Ashley Parker

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

Emily Carter

emily.carter@northwind.io

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

Jake Morgan

jake.morgan@northwind.io

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

M

Megan Brooks

megan.brooks@northwind.io

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

T

Tyler Reed

tyler.reed@northwind.io

Perkville Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

R

Ryan Hayes

ryan.hayes@northwind.io

Perkville Challenges Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

A

Ashley Parker

ashley.parker@northwind.io

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 Emily Carter

  1. ✓

    Schedule

    Every weekday at 8:00 AM

    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.

Does the Perkville MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. Perkville is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

Is Elaichi an alternative to Zapier MCP for Perkville?

Yes. Both let Claude, ChatGPT or Cursor use Perkville. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every Perkville call.

How is Elaichi different from Composio for Perkville?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to Perkville: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

Put Perkville in front of your team

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

Works with
Claude ChatGPT Cursor and any other MCP client, or the Elaichi Agent.
When the trial ends
Nothing is deleted. Connections, roles and the audit log stay where they are, so subscribing picks up exactly where you left off.