Can I use Ashby as a CLI?

Yes. KosmoKrator exposes a Ashby CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Ashby through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Ashby tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Ashby credentials stored?

Ashby credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Ashby MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Ashby MCP, CLI, and Lua Integration for AI Agents

Ashby integration docs for AI agents: MCP gateway setup, Ashby CLI commands, Lua API reference, credentials, and function schemas.

Ashby for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Ashby CLIHeadless setup, JSON output, direct function calls. Ashby MCPExpose selected tools to local MCP clients. Ashby LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: ashby
route_slug: ashby
package: ashby
auth_strategy: basic_api_key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Parameters	Description
`ashby.ashby_api_post`	Write `write`	0	Call any Ashby RPC API endpoint.
`ashby.ashby_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Ashby user. Use this to verify API access and see user details.
`ashby.ashby_list_users`	Read `read`	0	List Ashby users.
`ashby.ashby_list_candidates`	Read `read`	4	List candidates from Ashby with cursor pagination and sync tokens. Use ashby_search_candidates for name or email lookups.
`ashby.ashby_search_candidates`	Read `read`	0	Search candidates by name or email.
`ashby.ashby_get_candidate`	Read `read`	0	Get a single candidate.
`ashby.ashby_create_candidate`	Write `write`	0	Create a candidate.
`ashby.ashby_update_candidate`	Write `write`	0	Update a candidate.
`ashby.ashby_create_note`	Write `write`	3	Create a note in Ashby attached to a candidate, application, or job. Notes are visible to the hiring team and appear in activity feeds.
`ashby.ashby_list_candidate_notes`	Read `read`	0	List notes for a candidate.
`ashby.ashby_list_applications`	Read `read`	4	List job applications in Ashby. Returns applications with candidate info, status, and associated job. Use filters to narrow by job or status.
`ashby.ashby_get_application`	Read `read`	1	Get detailed information about a specific job application in Ashby, including candidate details, status, and evaluation data.
`ashby.ashby_create_application`	Write `write`	0	Create an application for a candidate and job.
`ashby.ashby_update_application`	Write `write`	0	Update an application.
`ashby.ashby_list_criteria_evaluations`	Read `read`	0	List AI criteria evaluations for an application.
`ashby.ashby_list_jobs`	Read `read`	3	List job postings in Ashby. Returns open and closed positions with department, location, and application count. Filter by status to find active openings.
`ashby.ashby_search_jobs`	Read `read`	0	Search jobs.
`ashby.ashby_get_job`	Read `read`	1	Get detailed information about a specific job in Ashby, including full description, requirements, compensation, and hiring team.
`ashby.ashby_create_job`	Write `write`	0	Create a job.
`ashby.ashby_update_job`	Write `write`	0	Update a job.
`ashby.ashby_list_job_postings`	Read `read`	0	List job postings.
`ashby.ashby_get_job_posting`	Read `read`	0	Get a job posting.
`ashby.ashby_list_openings`	Read `read`	0	List openings.
`ashby.ashby_create_opening`	Write `write`	0	Create an opening.
`ashby.ashby_list_departments`	Read `read`	0	List departments/teams.
`ashby.ashby_list_locations`	Read `read`	0	List locations.
`ashby.ashby_list_sources`	Read `read`	0	List sources.
`ashby.ashby_list_interviews`	Read `read`	3	List scheduled interviews in Ashby. Returns interview details with date, time, interviewers, and associated application. Filter by application to see interviews for a specific candidate.
`ashby.ashby_get_interview`	Read `read`	1	Get detailed information about a specific interview in Ashby, including scheduled time, interviewers, feedback, and scorecards.
`ashby.ashby_list_interview_plans`	Read `read`	0	List interview plans.
`ashby.ashby_list_interview_schedules`	Read `read`	0	List interview schedules.
`ashby.ashby_update_interview_schedule`	Write `write`	0	Update an interview schedule.
`ashby.ashby_list_interview_events`	Read `read`	0	List interview events.
`ashby.ashby_list_offers`	Read `read`	0	List offers.
`ashby.ashby_get_offer`	Read `read`	0	Get an offer.
`ashby.ashby_create_offer`	Write `write`	0	Create an offer.
`ashby.ashby_update_offer`	Write `write`	0	Update an offer.
`ashby.ashby_approve_offer`	Write `write`	0	Approve an offer.
`ashby.ashby_get_file`	Read `read`	0	Retrieve a file URL.
`ashby.ashby_set_custom_field_value`	Write `write`	0	Set a custom field value.
`ashby.ashby_list_webhooks`	Read `read`	0	List webhook settings.
`ashby.ashby_get_webhook`	Read `read`	0	Get a webhook setting.
`ashby.ashby_create_webhook`	Write `write`	0	Create a webhook setting.
`ashby.ashby_update_assessment`	Write `write`	0	Update assessment status/results.