Aptora for AI assistants
Connect Aptora to Claude, ChatGPT or Cursor and let your assistant build profiles, search the job board and apply on your behalf. Everything on this page works with a free account.
The server address
Point any MCP-capable client at this URL. There are no API keys: the first request opens a browser window where you sign in and choose what to grant.
https://aptora.io/mcpTransport: streamable HTTP (JSON-RPC). Authorization: OAuth 2.1 with PKCE and dynamic client registration, so most clients need nothing but the URL.
Connect your client
Pick the assistant you use. Each takes under a minute.
Cursor
- 1Use the “Add to Cursor” button on our home page, or paste the config below into ~/.cursor/mcp.json.
- 2Cursor opens a browser window once. Sign in to Aptora and confirm the permissions you want to grant.
- 3Ask the agent in chat — the Aptora tools appear automatically.
{
"mcpServers": {
"aptora": {
"url": "https://aptora.io/mcp"
}
}
}Claude
- 1In Claude, open Settings → Connectors → Add custom connector, and paste the server URL.
- 2Confirm “Add”, then sign in to Aptora when Claude asks to authorize.
- 3Start a new chat — Aptora shows up in the tools menu.
claude mcp add --transport http aptora https://aptora.io/mcpChatGPT
- 1Enable developer mode: Settings → Apps and connectors → Advanced → Developer mode.
- 2Create a new connector, paste the server URL and confirm.
- 3Sign in to Aptora when ChatGPT asks to authorize, then start a chat with the connector enabled.
https://aptora.io/mcpInteractive components (a rendered profile card instead of raw JSON) need the connector loaded as an app in developer mode. Without it the tools still work and answer with plain data.
Things to ask for
Copy one and change the details. Each uses several tools together — your assistant chains them on its own.
Import a résumé
Here is my CV as a PDF export. Build an Aptora profile from it, keep every position and project, and check it validates before you save.
Find work
Search the Aptora job board for remote freelance backend roles, show me the three best matches with day rates, and open the details of the most interesting one.
Apply to a job
Apply to that job with my backend profile. Draft the application mail for me to review — do not send anything yet.
Keep a profile current
Add my new role at Nordkapp Systems, starting last September, to my main profile. Leave every other section exactly as it is.
Source candidates (team workspaces)
Publish this job spec to our board, then find matching candidates and shortlist the top three with a note on why.
What your assistant can do
Tools are grouped by what they touch. Your client only sees the ones you granted at sign-in.
Profiles
Read, create, update and delete your profiles, plus the full résumé schema and a dry run that reports what a write would store.
Job board
Browse and filter public listings and read a full job spec, including the application contact where a listing carries one.
Applications
File an application with a chosen profile and get back a ready-to-send mail. Nothing is ever sent for you.
Recruiting
For team workspaces: write and publish your own listings, search candidates, keep a shortlist and reach out. Needs a plan that includes them.
What you are granting
The sign-in screen lists exactly which of these a client asked for, and you can refuse any of them. Tools you did not grant are not even offered to the assistant.
You can review and revoke any connection at any time under Settings → Integrations.
Good to know
- Applying publishes the profile you chose at a public share link, and visits to it are counted. Your assistant has to ask you before it does that.
- In a personal workspace a profile is always about you: an imported candidate's name is replaced with your account name. Import someone else's résumé into a team workspace to keep theirs.
- Candidate results never contain contact details. Reaching a person goes through Aptora, one recipient at a time, and each candidate can switch it off.
- Aptora drafts application mail. It never sends mail on your behalf.
If something does not work
The assistant says it has no Aptora tools
The connection is not authorized yet, or you granted a narrower set of permissions than the task needs. Reconnect and check the boxes on the sign-in screen.
It keeps asking me to sign in
Access expires after an hour and refreshes silently. If it does not, remove the connector in your client and add it again — the old grant may have been revoked.
I only see JSON, no profile card
Interactive components are rendered by the client, not by us. In ChatGPT they need the connector loaded as an app in developer mode; the data itself is correct either way.
A tool is offered but fails when called
The client is holding a cached tool list from an older version of the server. Reconnect the connector to refresh it.