Read your actual results
Use a read-only key to query your tasks, credits and the records in your account.
AI & agents
Real data. Useful tools for your AI.
Give your assistant access to your Octrieve workspace. Read actual results, run budgeted jobs, and export a CSV through the customer API or MCP.
Customer API and API-key MCP are available to registered accounts.
From a key to actual results.
Create a scoped key
01Sign in, create a key and save it in your MCP client or server’s secret store. Check available modes and credits.
Run a budgeted job
02Confirm the target and maxCredits. Create with a UUID; poll the job id and keep that UUID for retries.
Read or download results
03Read paginated JSON results or export CSV when the job finishes. MCP gives you a short-lived download link.
AI & agents
Useful context starts with actual records.
Create within a budget
A write key can create and cancel jobs. Each new job requires a credit cap and a UUID for safe retries.
Keep large files out of the chat
MCP returns a 15-minute CSV link. Read paginated results when your assistant needs only a few records.
Start with permissions. Finish with results.
Use a read-only key for existing data, or choose write access when your assistant needs to create a task.
- 01
Create a scoped key
Sign in, create a key and save it in your MCP client or server’s secret store. Check available modes and credits.
- 02
Run a budgeted job
Confirm the target and maxCredits. Create with a UUID; poll the job id and keep that UUID for retries.
- 03
Read or download results
Read paginated JSON results or export CSV when the job finishes. MCP gives you a short-lived download link.
AI & agents
Give your assistant a grounded start.
Read the live documentation first, then check permissions and the user’s budget before creating a task.
A few things to know.
Can I connect through API or MCP today?
Yes. Registered accounts can create a customer API key. Use REST, an MCP client that accepts Bearer headers, or the standalone stdio bridge. The site administrator can disable access.
Do you support OAuth-only MCP clients?
This version uses pre-issued API keys. It does not offer an OAuth sign-in or consent flow. Use a client that supports Bearer headers or local stdio processes.
Do I need a paid plan for API or MCP?
No. Free, Pro and Max use the same allowance and mode restrictions as the website. Annual plans still grant credits monthly. A write key and an explicit budget are required to create jobs.
Can AI fill in missing contact details?
Ask your assistant to flag missing information rather than guess it. A collected email is not a deliverability guarantee, and the export should not be treated as proof of verification.