[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Sumble job title classification](https://spiral.ai/integrations/hermes/sumble-job-title-classification)

# How to Use Sumble job title classification in Hermes

Maps job titles to Sumble's standard job functions and seniority levels. Use it to make differently worded titles comparable before organizing hiring research or choosing role categories.

|  |  |
| --- | --- |
| Model | Sumble job title classification |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | Up to $0.17459 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Sumble job title classification in Hermes

- Every Friday, use Sumble job title classification to refresh the classifications for 'Software Engineer', 'Senior Software Engineer', and 'Engineering Manager'. Report the returned functions and seniority levels and flag changes from the previous review.
- Once a month, use Sumble job title classification for 'Data Engineer', 'Senior Data Scientist', and 'Machine Learning Engineer'. Include the returned functions and levels in our internal role-category review.
- Every Monday at 9am: use Sumble job title classification to look this up and give me the result as a table.
- Pull the latest numbers from Sumble job title classification and tell me what changed since last week.
- Check Sumble job title classification and summarize what you find in three bullet points.

## How to set up Sumble job title classification in Hermes

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Hermes this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Sumble job title classification**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "sumble/jobs/titles",
    "input": {
      "titles": [
        "<titles>"
      ]
    }
  }'
```

Then paste one of the prompts above: Hermes finds Sumble job title classification on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/hermes

## Sumble job title classification tools and prices

- [Sumble · Job title lookup](https://spiral.ai/tools/alexandria/sumble/jobs/titles) (Alexandria): Up to $0.17459 per run.

## What can you do with Sumble job title classification in Hermes?

Deliver a recurring internal hiring review for a fixed company watchlist. A scheduled agent can compare retrieved posting records and classify titles as they enter the review.

### Prepare an account hiring brief

Review a target company's postings and organize their titles into standard functions and seniority levels. Build an internal brief showing which roles support each hiring observation.

### Compare competitors' hiring priorities

Compare postings from companies such as Snowflake and Databricks, then classify titles consistently. Separate differences in role wording from differences in the functions being recruited.

### Research demand for developer tools

Examine postings that mention a technology and classify the associated roles. Use the results to plan internal research around the functions and seniority levels appearing in those postings.

### Build a weekly hiring review

Review newly retrieved postings for a fixed company watchlist and classify unfamiliar titles. Summarize changes by function and seniority for an internal planning meeting.

### Investigate technology initiatives

Read postings associated with projects such as cloud migration and organize their titles by function and level. Keep the posting evidence alongside any proposed interpretation of the initiative.

### Prepare a regional hiring comparison

Review a company's postings across locations and apply consistent role classifications. Compare the retrieved roles by function and seniority without treating title wording as a category.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Hermes guides](https://spiral.ai/integrations/hermes)

## Sumble job title classification in other agents

- [Amp](https://spiral.ai/integrations/amp/sumble-job-title-classification)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/sumble-job-title-classification)
- [Claude](https://spiral.ai/integrations/claude-desktop/sumble-job-title-classification)
- [Claude Code](https://spiral.ai/integrations/claude-code/sumble-job-title-classification)
- [Cline](https://spiral.ai/integrations/cline/sumble-job-title-classification)
- [Codex](https://spiral.ai/integrations/codex/sumble-job-title-classification)
- [Cursor](https://spiral.ai/integrations/cursor/sumble-job-title-classification)
- [Devin](https://spiral.ai/integrations/devin/sumble-job-title-classification)
- [dots](https://spiral.ai/integrations/dots/sumble-job-title-classification)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/sumble-job-title-classification)
- [Gemini](https://spiral.ai/integrations/gemini/sumble-job-title-classification)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/sumble-job-title-classification)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/sumble-job-title-classification)
- [goose](https://spiral.ai/integrations/goose/sumble-job-title-classification)
- [Grok](https://spiral.ai/integrations/grok/sumble-job-title-classification)
- [Grok Build](https://spiral.ai/integrations/grok-build/sumble-job-title-classification)
- [Instinct](https://spiral.ai/integrations/instinct/sumble-job-title-classification)
- [Manus](https://spiral.ai/integrations/manus/sumble-job-title-classification)
- [Muse](https://spiral.ai/integrations/muse/sumble-job-title-classification)
- [Muse Code](https://spiral.ai/integrations/muse-code/sumble-job-title-classification)
- [n8n](https://spiral.ai/integrations/n8n/sumble-job-title-classification)
- [Notion](https://spiral.ai/integrations/notion/sumble-job-title-classification)
- [OpenClaw](https://spiral.ai/integrations/openclaw/sumble-job-title-classification)
- [opencode](https://spiral.ai/integrations/opencode/sumble-job-title-classification)
- [Perplexity](https://spiral.ai/integrations/perplexity/sumble-job-title-classification)
- [Raycast](https://spiral.ai/integrations/raycast/sumble-job-title-classification)
- [VS Code](https://spiral.ai/integrations/vscode/sumble-job-title-classification)
- [Windsurf](https://spiral.ai/integrations/windsurf/sumble-job-title-classification)
- [Zapier](https://spiral.ai/integrations/zapier/sumble-job-title-classification)

## More Hermes guides

- [Sumble job posts](https://spiral.ai/integrations/hermes/sumble-job-posts)
- [Sumble location codes](https://spiral.ai/integrations/hermes/sumble-location-codes)
- [Sumble conference search](https://spiral.ai/integrations/hermes/sumble-conference-search)
- [Sumble priority signal digest](https://spiral.ai/integrations/hermes/sumble-priority-signal-digest)
- [Sumble conference details](https://spiral.ai/integrations/hermes/sumble-conference-details)
- [Sumble project lookup](https://spiral.ai/integrations/hermes/sumble-project-lookup)

## Questions about Sumble job title classification in Hermes

**Can Hermes use Sumble job title classification?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Sumble job title classification like any built-in tool.

**How much does Sumble job title classification cost in Hermes?**

Up to $0.17459 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

**Do I need an Alexandria account to use Sumble job title classification in Hermes?**

No. Spiral runs Sumble job title classification on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Sumble job title classification in Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while Sumble job title classification runs?**

Sumble job title classification runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Where does Sumble get its job-post data?**

Sumble ingests postings from job aggregators and company careers pages. These postings provide the underlying hiring evidence for its job data.

**How often does Sumble refresh job postings?**

Sumble ingests new postings multiple times daily. Its documentation describes ingestion throughout the day, rather than an immediate feed of every employer change.

**Which companies does Sumble cover best?**

Sumble covers the global job market, with its deepest coverage among technology companies and active hirers. Company comparisons should account for that coverage boundary.

**Are Sumble's role categories copied directly from employers?**

Sumble uses machine learning to classify job functions from postings. Its title lookup maps supplied wording to canonical functions and levels, so the categories are standardized classifications.

**Can I reuse Sumble data in a public product or model dataset?**

The standard API license permits internal business use. Sumble also expressly prohibits using its services as training, fine-tuning, or evaluation data for AI models.

