Skip to content

Perkville MCP connector

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

  • Connects over OAuth
  • Free 14-day trial
  • No credit card
ChatGPT Elaichi connected

Which Perkville challenges have unmet requirements this month?

Working in Perkville with Elaichi

  • List all Perkville agreement versions
  • Get single Perkville agreement version by ID
  • List all Perkville businesses
Ask anything…
Governance / Audit log Last 24 hours
Perkville List all Perkville businesses Emily Carter · ChatGPT · 9:41 AM Done
Perkville Get single Perkville agreement version by ID Emily Carter · ChatGPT · 9:41 AM Done
Perkville List all Perkville agreement versions Emily Carter · ChatGPT · 9:41 AM Done
Perkville Get single Perkville business by ID Megan Brooks · Claude · 9:38 AM Done
Perkville List all Perkville staff Ryan Hayes · Cursor · 9:35 AM Done

How to connect Perkville to Claude, ChatGPT, Cursor or Microsoft Copilot

Step by step, for each AI app

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 Claude Code

  1. 1

    In a terminal, run claude mcp add with the endpoint.

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

    Start Claude Code and run /mcp.

  3. 3

    Pick elaichi, then sign in and approve in the browser.

Terminal

$ claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp

Use --scope project instead to share it with the repository through .mcp.json.

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. 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.

Perkville MCP connector for Microsoft Copilot

  1. 1

    In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.

  2. 2

    Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.

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

    Create a new connection, sign in and approve, then press Add to agent.

  4. 4

    Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Server URL
https://api.elaichi.ai/mcp
Authentication
OAuth 2.0
Type
Dynamic discovery

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

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.

What teams do with Perkville through Elaichi

Ask in plain English. Each person’s AI can do only what they’re allowed to, and every action it takes in Perkville is logged.

  • 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 →

What connecting Perkville gets you

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

Elaichi Agent

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, Cursor or Microsoft Copilot

The agent

Ask about challenges, get real answers.

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

ElaichiAI apps
Claude ChatGPT Cursor Microsoft Copilot

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

AI apps

Claude, ChatGPT, Cursor and Microsoft Copilot reach Perkville.

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

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.

Tool catalog

85 Perkville tools ready to call.

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

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

Toolboxes

Every team gets its own toolbox.

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

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

Shared connections

Teammates use Perkville without a credential.

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

ElaichiAudit log
When Who What happened Type

2 minutes ago

Mar 6, 2026, 3:10 PM

E

Emily Carter

[email protected]

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

Jake Morgan

[email protected]

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

M

Megan Brooks

[email protected]

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

T

Tyler Reed

[email protected]

Perkville Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

R

Ryan Hayes

[email protected]

Perkville Challenges Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

A

Ashley Parker

[email protected]

Perkville Challenges List Toolbox

Audit log

Every Perkville call has a name on it.

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

From answering questions to doing the work

A trigger starts the work, inside the same permissions and the same audit log as everything else. Automations, collections and live dashboards come with the Black plan.

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 Jake Morgan

    Approve
  6. Post the digest

    Perkville

    Queued

Automations

A schedule drafts your challenge digest.

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

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%

Collections and dashboards

Perkville health, counted not guessed.

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

For IT and engineering

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 Free for one person; $15 per user per month on Gold. 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.

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.

Questions, answered

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, Microsoft Copilot, 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 restrict specific Perkville actions, such as creating or updating a member connection, while leaving lookups open. A restricted action still appears in Elaichi's tool search, flagged as restricted, but Claude, ChatGPT, Cursor or Microsoft Copilot cannot run it, whatever the prompt says.

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, Microsoft Copilot, 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, Microsoft Copilot, 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 of Black, no credit card. Connect it once and pick what each team can call.

When the trial ends, nothing is deleted. You move to the free Personal plan, and connections, roles and the audit log stay where they are.

Add one link to your AI app

The same link for everyone on your team.

https://api.elaichi.ai/mcp
  • ChatGPT
  • Claude
  • Cursor
  • Microsoft Copilot