MCP server

Career help in any AI app, for people and their agents.

The Kariaa MCP server brings Kariaa into the AI app a person already uses (Claude, ChatGPT, Perplexity, Cursor, VS Code or any Model Context Protocol client) for anything about their work and career, and serves the agents working on their behalf too. It runs at agent.kariaa.com/mcp. It searches live openings on LinkedIn, Indeed, Glassdoor and national boards, and freelance projects, bounties and competitions on Freelancer, Kaggle, Algora, HackerOne and more. It opens postings so the app can tailor a resume or cover letter, checks offers for scam signs and shows what a role pays. With the person signed in, it applies to paid work, attaches and submits the work, runs Kariaa's DataHouse tasks and shows earnings and payouts. Search needs no key.

Endpoint

https://agent.kariaa.com/mcp

Streamable HTTP, JSON responses. Search, job details, scam checks, pay and the task list need no key. Applying, submitting work, samples, saved jobs and earnings act for a person: sign in with Kariaa at https://agent.kariaa.com/mcp/auth or send Authorization: Bearer kra_…. Machine-readable card: server-card.json.

Claude Desktop: download kariaa.mcpb and open it. Local-only clients: npx -y @kariaa/mcp.

Ask your assistant

  • Find registered nurse jobs in Austin, Texas posted this week.
  • Find remote Python freelance work or bounties I could start today.
  • Is this recruiter message a scam? (paste it)
  • What does an accountant earn in Lagos?
  • Open the second job and write me a cover letter for it.

Set up your app

Two ways in. Sign in with Kariaa: the app adds https://agent.kariaa.com/mcp/authand opens a sign-in page; no key to copy, and the app shows up under Connect an agent as "<app> (app)" (remove it there to disconnect). A key: made at Connect an agent and sent as Authorization: Bearer kra_… to https://agent.kariaa.com/mcp.

Chat apps

Add Kariaa as a connector and sign in. Search company ATS boards (Greenhouse, Ashby, Lever) and DataHouse tasks with no key to copy.

ClaudeSign in
Open Claude connectors
  1. In Claude (web or desktop) open Connectors and choose Add custom connector.
  2. Paste https://agent.kariaa.com/mcp/auth as the address and name it Kariaa.
  3. Continue, then sign in with Kariaa when Claude asks. The mobile apps pick it up too.
Use a key instead
https://agent.kariaa.com/mcp
Authorization: Bearer kra_YOUR_KEY
  1. Add a custom connector with this address and put the Authorization line under Request headers.

The free plan allows one custom connector.

ChatGPTSign in
Open ChatGPT
  1. Settings, then Apps & Connectors, then Advanced: turn on Developer mode.
  2. Create a connector named Kariaa with https://agent.kariaa.com/mcp/auth and authentication set to OAuth.
  3. Sign in with Kariaa when ChatGPT asks, then pick Kariaa from the + menu in a chat.
PerplexitySign in
Open Perplexity connectors
  1. Add custom, then Connector, then Add MCP connector, then Remote.
  2. Name it Kariaa, paste https://agent.kariaa.com/mcp/auth as the address, transport Streamable HTTP, authentication OAuth 2.0.
  3. Open the Kariaa card and sign in with Kariaa.
Use a key instead
https://agent.kariaa.com/mcp
API key: kra_YOUR_KEY
  1. Same path, with the address https://agent.kariaa.com/mcp and authentication set to API Key.
Le ChatSign in
Open Le Chat
  1. Connectors, then Add Connector, then the Custom MCP Connector tab (workspace admins).
  2. Name it kariaa, paste https://agent.kariaa.com/mcp/auth and connect. Le Chat detects the sign-in and opens it.
Use a key instead
https://agent.kariaa.com/mcp
Bearer token: kra_YOUR_KEY
  1. Paste https://agent.kariaa.com/mcp and choose Bearer with your key.

Coding agents and editors

One command or one config block. Public discovery works without a key; add a key or OAuth to apply and submit work.

Claude CodeSign in
claude mcp add --transport http kariaa https://agent.kariaa.com/mcp/auth
  1. Run the command in your terminal.
  2. In Claude Code run /mcp, pick kariaa and sign in with Kariaa (or run: claude mcp login kariaa).
Use a key instead
claude mcp add --transport http kariaa https://agent.kariaa.com/mcp --header "Authorization: Bearer kra_YOUR_KEY"
  1. Run the command, then /mcp to confirm kariaa is connected.
CodexSign in
codex mcp add kariaa --url https://agent.kariaa.com/mcp/auth
codex mcp login kariaa
  1. Run both commands; the second opens your browser to sign in with Kariaa.
  2. In the IDE extension: the gear, then MCP servers, then Add server, Streamable HTTP, Authenticate.
Use a key instead
~/.codex/config.toml[mcp_servers.kariaa]
url = "https://agent.kariaa.com/mcp"
bearer_token_env_var = "KARIAA_KEY"
  1. Add this to ~/.codex/config.toml and set KARIAA_KEY to your key in your shell.
CursorSign in
Add to Cursor
  1. Click Add to Cursor and confirm the install.
  2. Cursor Settings, then MCP: find kariaa and click Sign in.
Use a key instead
.cursor/mcp.json{
  "mcpServers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. Or paste this into .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project.
VS Code and GitHub CopilotSign in
Add to VS Code
  1. Click Add to VS Code and confirm; VS Code asks you to sign in with Kariaa.
  2. Or Command Palette, MCP: Add Server, HTTP, and paste https://agent.kariaa.com/mcp/auth as the address.
Use a key instead
.vscode/mcp.json{
  "servers": {
    "kariaa": {
      "type": "http",
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. Save this as .vscode/mcp.json.
  2. Copilot CLI: copilot mcp add --transport http --header "Authorization: Bearer <key>" kariaa https://agent.kariaa.com/mcp
Gemini CLISign in
gemini mcp add --transport http kariaa https://agent.kariaa.com/mcp/auth
  1. Run the command, then /mcp auth kariaa inside Gemini CLI to sign in with Kariaa.
Use a key instead
gemini mcp add --transport http --header "Authorization: Bearer kra_YOUR_KEY" kariaa https://agent.kariaa.com/mcp
  1. In settings.json the field is httpUrl, not url.
WindsurfSign in
Open the Windsurf MCP docs
  1. Cascade panel, the three dots, then Open MCP config file.
  2. Add kariaa with serverUrl https://agent.kariaa.com/mcp/auth and sign in when prompted.
Use a key instead
~/.config/devin/mcp_config.json{
  "mcpServers": {
    "kariaa": {
      "serverUrl": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. On Windows the file is %APPDATA%\devin\mcp_config.json.

Windsurf now ships as Devin Desktop; the config file is the same.

ClineKey
cline_mcp_settings.json{
  "mcpServers": {
    "kariaa": {
      "type": "streamableHttp",
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. MCP Servers, then Remote Servers: name kariaa, address https://agent.kariaa.com/mcp over Streamable HTTP, Add Server.
  2. Or paste this block into cline_mcp_settings.json.
ZedSign in
settings.json{
  "context_servers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp/auth"
    }
  }
}
  1. Add this to Zed's settings.json; Zed prompts you to sign in with Kariaa.
Use a key instead
settings.json{
  "context_servers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. Same place, with the header instead of the sign-in.
KiroSign in
.kiro/settings/mcp.json{
  "mcpServers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp/auth"
    }
  }
}
  1. Save it as .kiro/settings/mcp.json in the project, or ~/.kiro/settings/mcp.json; Kiro opens the browser to sign in.
Use a key instead
.kiro/settings/mcp.json{
  "mcpServers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. Same file, with the header instead of the sign-in.
JetBrains AI AssistantPublic tools
{
  "mcpServers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp"
    }
  }
}
  1. Settings, Tools, AI Assistant, Model Context Protocol (MCP), Add, then paste.
  2. JetBrains sends no sign-in or key yet, so you get the public job tools (search, check a posting, pay) but not your DataHouse tasks.
ReplitSign in
Add to Replit
  1. Click Add to Replit and sign in with Kariaa when the integrations page asks.

Desktop and local

Apps that run on your own machine.

LM StudioKey
mcp.json{
  "mcpServers": {
    "kariaa": {
      "url": "https://agent.kariaa.com/mcp",
      "headers": {
        "Authorization": "Bearer kra_YOUR_KEY"
      }
    }
  }
}
  1. Click Add to LM Studio, or Program tab, Install, Edit mcp.json and paste the block.
RaycastSign in
Open the Raycast MCP guide
  1. Run the Install MCP Server command in Raycast.
  2. Transport HTTP, URL https://agent.kariaa.com/mcp/auth with OAuth type Dynamic.
Use a key instead
https://agent.kariaa.com/mcp
Authorization: Bearer kra_YOUR_KEY
  1. Transport HTTP, URL https://agent.kariaa.com/mcp and add the HTTP header below.
GooseKey
Remote Extension (Streaming HTTP)
URL: https://agent.kariaa.com/mcp
Header: Authorization=Bearer kra_YOUR_KEY
  1. Click Add to Goose (desktop), or run goose configure, Add Extension, Remote Extension, and enter the address and header.

Any Streamable HTTP client

POST JSON-RPC to the endpoint with Accept: application/json, text/event-stream and the Authorization header. Clients that speak MCP OAuth can use https://agent.kariaa.com/mcp/auth instead; it answers 401 with the resource metadata the flow needs.

Jobs

search_jobs
Live openings for a role near a place or remote, from LinkedIn, Indeed, Glassdoor, ZipRecruiter, national boards and remote-job sites. kind "paid_tasks" or "all" adds freelance, bounties and competitions.
get_job
One result in full: description, requirements, pay when stated, and how to apply.
check_job_post
Scam warning signs in a post, recruiter message or offer, each with the quoted line.
estimate_pay
What employers state for a role in a city or country, with how many postings and examples.
save_job
Keep a job on the person's list. Needs sign-in.
my_saved_jobs
The person's saved jobs, with whether each is still open. Needs sign-in.

Paid work on other platforms

list_platforms
The freelance, bounty, competition and agent-task platforms Kariaa searches, and what the agent can do on each.
connect_platform
The link where the person links their own account on a platform.
apply_to_work
Apply to a paid task, bounty, competition or project as the person. Needs sign-in.
add_work
Attach the finished work to an application. Needs sign-in.
submit_work
Send the work for review. Needs sign-in.

DataHouse tasks

list_tasks
Kariaa's open data tasks: kind, the unpaid verification sample, the rate after verification.
get_task
One task in full: material, how-to steps, an example, rules, questions, rate.
whoami
Who is signed in, whether the basics are in, today's usage.
update_profile
Legal name, phone, location, occupation, language. Needs sign-in.
apply_to_task
Join a task with the required answers and an optional preferred rate. Needs sign-in.
request_upload
A signed URL for one sample file. Needs sign-in.
confirm_upload
Register the uploaded file as a sample. Needs sign-in.
get_upload_link
For apps that can't send files: a one-tap upload link for the person's phone. Needs sign-in.
remove_sample
Take back a wrong file before submitting. Needs sign-in.
add_text_sample
A written answer for a text task. Needs sign-in.
submit_samples
Send the samples for review. Needs sign-in.
my_submissions
Every task the person joined, with its stage. Needs sign-in.
get_submission
One task's stage, files and review outcome. Needs sign-in.

Earnings

my_earnings
The person's Kariaa balance, ledger and payout requests. Needs sign-in.
request_payout
Cash out the balance: PayPal, Venmo, gift card or crypto. Needs sign-in.

Paid work, step by step

  1. search_jobs with kind: "paid_tasks", then get_job on the one the person picks.
  2. If it says to link an account, connect_platform gives the person the link.
  3. apply_to_work once the person says yes; then add_work and submit_work.

DataHouse, step by step

  1. list_tasks, then get_task for the one you want.
  2. whoami; if basics are missing, update_profile.
  3. apply_to_task with the task's required answers (and your preferred rate, if any).
  4. For each sample: request_upload, PUT the file to the URL, confirm_upload. A text task takes add_text_sample. An app that cannot send files uses get_upload_link.
  5. submit_samples, then get_submission for the review.

Limits and rules

  • Samples are unpaid: they only verify that the person can do the task and that the content is their own. Verified people are offered paid work at the task's rate, or the rate they asked for.
  • Every task carries how-to steps, an example and rules (get_task); read them to the person before they record.
  • One application per task; up to 10 files per task, 100 MB each, kinds per task.
  • Writes are limited per key per day; job searches to 30 an hour per key (10 without one); reads are generous.
  • Using a key means the person agrees to the Terms and is responsible for everything done with it, including by their agent. Samples don't guarantee paid work or a job, and may be shared with the task's reviewers and clients.
  • Samples must be your own, made for the task. Revoke a key at /datahouse/connect the moment you stop using the agent.

FAQ

Questions about the MCP server

What is the Kariaa MCP server?

An MCP (Model Context Protocol) server at agent.kariaa.com/mcp that gives AI assistants and agents job search and paid work: live openings from job boards, freelance projects, bounties and competitions from other platforms, scam checks, pay ranges, applying to paid work, DataHouse tasks, and earnings.

Is there an MCP server for job search?

Yes. Connect https://agent.kariaa.com/mcp to Claude, ChatGPT, Cursor, VS Code or any MCP client. search_jobs finds live openings for a role near a place or remote; with kind "paid_tasks" it finds freelance work, bounties and competitions. No key or account is needed to search.

How does an agent authenticate?

Searching needs nothing. To act for a person, the chat apps sign in with Kariaa at agent.kariaa.com/mcp/auth; other clients send a per-person API key as a Bearer token. The person creates the key at kariaa.com/datahouse/connect or by sending /apikey to Kariaa in chat, and can revoke it at any time.

Which agents work with it today?

Any MCP client that speaks Streamable HTTP: Claude Code (claude mcp add --transport http), Cursor (.cursor/mcp.json with a headers block), Codex, VS Code and Windsurf, plus the Claude, ChatGPT and Perplexity apps as a custom connector at agent.kariaa.com/mcp/auth, where the person signs in with Kariaa instead of pasting a key.

What can the agent do with the key, and what can it not?

It can apply to paid work on platforms where the person linked an account, attach and submit the work, join DataHouse tasks, upload the person's own sample files, keep a list of saved jobs and request a payout. Job openings are applied to on the employer's page. It cannot see other people's data or change the account's login. Writes are limited per key per day.