CodeREADr MCP server
24 operations0 webhooks
Barcode scanning and data capture with CodeREADr - search and delete scan records, manage validation services, databases and app users, and read the scan uploads and API limits.
Try CodeREADr with your agent
Connect CodeREADr, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in CodeREADr on my account, then run one read-only example and show me the result.
CodeREADr tools and triggers
Tools are what your agent can do in CodeREADr through Corsair's MCP server. Triggers are the CodeREADr events a routine can start from.
Databases
- ClearDestructive
Delete every value in a database while keeping the database itself; the values cannot be restored
databases.clear
- CreateWrite
Create a database for validating barcode values; case sensitivity is fixed at creation
databases.create
- DeleteDestructive
Permanently delete a database and every value in it; refused while a service still uses it
databases.delete
- ListRead-only
List validation databases with their stored value count and linked services, optionally at a lighter info level
databases.list
- Show ValuesRead-only
Search and page through the barcode values stored in a database, with exact and partial match filters and a validity filter
databases.showValues
- UpdateWrite
Rename a validation database; its stored barcode values and linked services are unchanged
databases.update
- Upsert ValueWrite
Insert or update one barcode value with its response text and validity, without checking whether it already exists
databases.upsertValue
- Upsert ValuesWrite
Insert or update up to 100 barcode values in one request, each with its own database, response text, validity and trim setting
databases.upsertValues
Services
- CreateWrite
Create a service: how scans are validated (record, database, postback, webview) plus scan behaviour such as symbologies, auto-sync and scanner configuration
services.create
- DeleteDestructive
Permanently delete one or more services, or every service with `all`; deleted services cannot be restored
services.delete
- ListRead-only
List services with their validation method, postback URL, linked database and authorized users and questions
services.list
- UpdateWrite
Update a service; omitted variables keep their current value, except symbologies, which reset to the default set when left out
services.update
Users
- CreateWrite
Create an app user; an email address sends an invitation and requires the user to accept it before signing in
users.create
- DeleteDestructive
Permanently delete app users, or every app user with `all`; the account owner cannot be deleted
users.delete
- ListRead-only
List app users with their authorized services, device limit and creation date
users.list
- UpdateWrite
Update an app user: rename, change the password, or set the device limit
users.update
Devices
- ListRead-only
List the devices that have activated the app, with their UDID
devices.list
- UpdateWrite
Rename a device, which changes how the device appears in scan records and the account device list
devices.update
Questions
- CreateWrite
Create a data collection question, shown to the app user before or after a scan; choice types need answer options added separately
questions.create
- ListRead-only
List data collection questions with their type and answer options
questions.list
Scans
- DeleteDestructive
Permanently delete one or more scan records; deleted scans cannot be restored
scans.delete
- ListRead-only
Search and page through scan records with filters on date, service, device, user, status, barcode value and scan properties, returning each scan with its answers
scans.list
Limits
- RetrieveRead-only
Read the account API request limits remaining for the current minute and day
limits.retrieve
Uploads
- ListRead-only
List scan uploads from devices, with the device, service, user, status and scan count for each
uploads.list
Connect CodeREADr to Claude, ChatGPT or Cursor
- 1
Connect CodeREADr in Corsair
Add your CodeREADr API key once in Corsair. Corsair stores the credential encrypted and makes the CodeREADr API calls for your agent, so it never goes into a prompt or a config file. Connect CodeREADr
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs CodeREADr. On a ChatGPT personal plan, connect CodeREADr here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, CodeREADr's read and write operations run right away and its 5 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/codereadr, add the CodeREADr plugin, and connect with an API key. Then call methods like corsair.codereadr.api.databases.clear() from your app. Corsair keeps each tenant isolated.
Yes. CodeREADr requires an API key from your CodeREADr account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit CodeREADr, GitHub, Notion, Stripe, and the rest. Trigger CodeREADr from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for barcode scanning and data capture with CodeREADr - search and delete scan records, manage validation services, databases and app users, and read the scan uploads and API limits. Common builds include sync jobs, admin tooling, and agents that call CodeREADr APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per CodeREADr API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/codereadr in the open repo. When CodeREADr ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your CodeREADr data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store CodeREADr data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put CodeREADr on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 5 destructive CodeREADr operations. You can change a link's mode at hub.corsair.dev/me.