# WorldRole MCP

**English** | [简体中文](README.zh-CN.md)

Install the free plugin from this repository with Claude Code: `/plugin install worldrole --marketplace zzn199216/worldrole-mcp`. See [marketplace installation and free limits](docs/MARKETPLACES.md) for Gemini CLI, Qwen Code, and other clients. Direct installation does not imply an approved official listing.

**Find remote jobs worldwide or overseas roles offering visa sponsorship. Let AI help from search and match scoring through application.**

WorldRole is a free job-search MCP and agent workflow. It connects multiple job sources, your career context and application steps so your AI can identify worthwhile opportunities, prepare materials, assist with applications and follow up on replies.

## How far can your AI take you?

| Stage | What you get |
|---|---|
| **Discover opportunities** | Search multiple sources for remote, overseas and visa-sponsorship opportunities, with original listing links |
| **Assess and score fit** | Evaluate matches against your experience, skills and preferences, with reasons, gaps and conditions to verify |
| **Prepare applications** | Reuse known experience and materials to draft and tailor letters and application content; collect essential missing details together |
| **Apply and follow up** | Use a connected mailbox or available tools for authorized sending, application records, follow-ups and routine replies; bring interviews, salary discussions and personal decisions to you |

Scores help prioritize applications; they are not hiring probabilities. Remote location eligibility and visa sponsorship must be checked against each job's actual requirements.

## Copy one request to get started

> Follow https://raw.githubusercontent.com/zzn199216/worldrole-mcp/main/INSTALL_FREE_SOURCES.md to install WorldRole and its free job sources for me. Handle setup and preserve my existing connections. Find remote jobs worldwide or overseas roles offering visa sponsorship that fit my experience and preferences, assess the matches and help prepare applications. Reuse known information and ask for essential missing details together.

Send it to an agent that can install tools and configure MCP. No registration, complete resume or mailbox setup is needed to start. For clients that only support web connections, see the [connection guide](docs/CLOUD_PROFILE.md).

## More free sources, less repeated setup

Sources include WorldRole, Himalayas, Jobicy, Arbeitnow, and company career pages on Greenhouse, Ashby and Lever. Your agent selects sources as needed, removes duplicate links and preserves attribution. You do not need to configure each source separately. Coverage and free quotas vary; your AI client or model may charge separately.

On first use, your agent gives two **0–10 scores** for its understanding of your career capabilities and its knowledge of your application materials, each with a short reason. These are separate from job-match scores and do not rate your ability. Even at zero, it can start exploring and learn as you go.

Reuse an existing mailbox connection. Actual email and form actions depend on available tools and authorization. Ongoing inbox checks require a running scheduled task; otherwise checks resume next time. Application records stay on your computer, and resumes and correspondence are not sent to job sources as search content.

---

[Manual setup and tools](docs/MANUAL.en.md) · [Mail and follow-ups](docs/APPLICATIONS.md) · [Source details](docs/SOURCES.md) · [Optional career summaries](docs/CLOUD_PROFILE.md) · [Contributing](CONTRIBUTING.md)

Original code and skills use the [MIT License](LICENSE). Third-party job data retains its own terms.