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
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
How to connect Perkville to Claude, ChatGPT, Cursor or Microsoft Copilot
Step by step, for each AI app
Perkville MCP connector for Claude
-
1
Open Customize, then Connectors.
-
2
Press Add.
-
3
Name it, paste the MCP server URL, then Continue.
https://api.elaichi.ai/mcp -
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
In a terminal, run
claude mcp addwith the endpoint.https://api.elaichi.ai/mcp -
2
Start Claude Code and run
/mcp. -
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
Open Plugins, then press the + button.
-
2
Name it and paste the endpoint into Server URL.
https://api.elaichi.ai/mcp -
3
Leave Authentication on OAuth, then tick the risk acknowledgement.
-
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
Open
~/.cursor/mcp.json. -
2
Add the endpoint under
mcpServers.https://api.elaichi.ai/mcp -
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
In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
-
2
Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
https://api.elaichi.ai/mcp -
3
Create a new connection, sign in and approve, then press Add to agent.
-
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
Add the endpoint as a remote MCP server.
https://api.elaichi.ai/mcp -
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.”
What connecting Perkville gets you
6 screens from Elaichi, each doing one job for your Perkville account.
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.
Copy the endpoint
AI apps
Claude, ChatGPT, Cursor and Microsoft Copilot reach Perkville.
One org-wide MCP endpoint over OAuth, no SDK and no shared API key.
Tool catalog
85 Perkville tools ready to call.
Businesses, staff, challenges, requirements and agreement versions covered without custom code.
Toolboxes
Every team gets its own toolbox.
Scope Perkville challenge tools to marketing while support keeps a narrower toolbox.
Shared connections
Teammates use Perkville without a credential.
See who connected each account and how many teams and members share it.
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
-
✓
Schedule
Every weekday at 8:00 AM
0.2s -
✓
Fetch challenges
Perkville
1.4s -
✓
Group by owner
Transform
0.1s -
✓
Draft the digest
Agent step
Ran with 4 tools, returned a structured summary
6.2s -
Approve the digest
Needs approval
Assigned to Jake Morgan
Approve Deny -
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
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.
| 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.
No tools match your search.
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 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