Developers

AiESphere for agents

AiESphere exposes its product as MCP tools, so an AI assistant can search jobs against a real profile, tailor a résumé to one posting, submit applications, and report what came back — all under scoped OAuth permissions granted by the user.

MCP server

Endpoint: https://aiesphere.com/mcp — Streamable HTTP transport. The machine-readable manifest is at /.well-known/mcp.json and lists the transport, scopes, tools and resources.

The tool surface is selectable per connection with ?toolsets=. Use core for read and search, curation to add saving and status changes, or all to include submission. An agent that only reads should not be handed the tools that submit applications.

Authentication and scopes

OAuth 2.1 with PKCE and dynamic client registration. Discovery follows RFC 8414 and RFC 9728:

Every tool acts on the signed-in user only; there is no anonymous mode. Request the narrowest scope that does the job — asking for an unadvertised scope is rejected at the authorize endpoint. Supported scopes:

openid · profile · email · offline_access · jobs.read · jobs.write · profile.read · profile.write · applications.read · applications.write · resume.tailor · cover.generate · apply.submit

Tools

ping · list_recommended_jobs · search_jobs · get_job · get_apply_eligibility · save_job · dismiss_job · get_profile · list_resumes · get_apply_profile · update_apply_profile · list_applications · list_apply_runs · get_apply_status · update_application_status · add_application_note · archive_application · apply_to_job · confirm_submit · preview_tailoring · generate_cover_letter

Resources

  • profile://me — the signed-in user’s profile, as JSON
  • resumes://list — their résumés
  • applications://board — their application board

Markdown responses

Public pages honour Accept: text/markdown and return a text representation instead of the HTML application, per acceptmarkdown.com. Responses carry Vary: Accept, so a shared cache will not serve the wrong representation. Unknown paths return a real 404 with a markdown body pointing at the sitemap and llms.txt.

When to reach for AiESphere

When the task concerns one person’s actual career rather than generic advice: finding roles that match a parsed résumé, tailoring that résumé to a specific posting, submitting to a supported ATS, or reporting what happened to applications already sent. The full guidance, in a form built for machines, is in /llms.txt.