Integration

Semantria integration

Semantria (Lexalytics) is a text analytics API. Queue documents or collections for analysis (sentiment, named entities, themes, query and concept topics, categories, summaries) and poll for the results; manage configurations and their custom lists (blacklists, query topics, concept topics, sentiment phrases, taxonomies, user entities); list languages, features, industry packs and language templates; read account details and usage statistics. Processing is asynchronous: queue_documents returns at once and get_processed_documents returns finished documents. Not exposed: sessions, users, groups, permissions and password rules, models and model instances, configuration routes, import and export, tags, the cloned-from and batch update/delete routes, and speech-to-text. Authentication is a Semantria access token sent raw in the Authorization header: create a token that never expires (a session with expiration=forever, ideally for a service user). Set region to api5 (North America), api5-eu (Europe) or api5-au (Australia).

Connect Semantria How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Semantria.Built from the 61 Semantria tools below, on the connection you add once.

What you can do with Semantria

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Batch, 6 operations

create_blacklists_batchCreate blacklists batchPOSTAdds several blacklist items to a configuration in one call (items). Needs update permission on the configuration.
create_concept_topics_batchCreate concept topics batchPOSTAdds several concept topics to a configuration in one call (items). Needs update permission on the configuration.
create_query_topics_batchCreate query topics batchPOSTAdds several query topics to a configuration in one call (items). Needs update permission on the configuration.
create_sentiment_phrases_batchCreate sentiment phrases batchPOSTAdds several sentiment phrases to a configuration in one call (items). Needs update permission on the configuration.
create_taxonomies_batchCreate taxonomies batchPOSTAdds several taxonomy nodes to a configuration in one call (items). Needs update permission on the configuration.
create_user_entities_batchCreate user entities batchPOSTAdds several user entities to a configuration in one call (items). Needs update permission on the configuration.

Blacklist, 5 operations

create_blacklistCreate blacklistPOSTAdds a blacklist item (a term to suppress from results) to a configuration. Needs update permission on the configuration.
delete_blacklistDelete blacklistDELETERemoves one blacklist item from a configuration. Needs update permission on the configuration.
get_blacklistGet blacklistGETReturns one blacklist item of a configuration by id.
list_blacklistsList blacklistsGETLists the blacklist items of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_blacklistUpdate blacklistPUTReplaces the definition of one blacklist item of a configuration. Needs update permission on the configuration.

Concept topic, 5 operations

create_concept_topicCreate concept topicPOSTAdds a concept topic (a category defined by sample words) to a configuration. Needs update permission on the configuration.
delete_concept_topicDelete concept topicDELETERemoves one concept topic from a configuration. Needs update permission on the configuration.
get_concept_topicGet concept topicGETReturns one concept topic of a configuration by id.
list_concept_topicsList concept topicsGETLists the concept topics of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_concept_topicUpdate concept topicPUTReplaces the definition of one concept topic of a configuration. Needs update permission on the configuration.

Config, 5 operations

create_configCreate configPOSTCreate a new configuration for an account. This endpoint is not used to add NLP features (like query topics) to a configuration.
delete_configDelete configDELETEDelete a configuration. This endpoint is not used to delete NLP feature items from a configuration. This action requires update permission for the configuration or the ACCOUNT_ADMIN permission.
get_configGet configGETGet details about a specific configuration.
list_configsList configsGETGet a list of all configurations for an account.
update_configUpdate configPUTUpdate an existing configuration. This endpoint is not used to update NLP feature lists such as query topics.

Query topic, 5 operations

create_query_topicCreate query topicPOSTAdds a query topic (a category defined by a Boolean query) to a configuration. Needs update permission on the configuration.
delete_query_topicDelete query topicDELETERemoves one query topic from a configuration. Needs update permission on the configuration.
get_query_topicGet query topicGETReturns one query topic of a configuration by id.
list_query_topicsList query topicsGETLists the query topics of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_query_topicUpdate query topicPUTReplaces the definition of one query topic of a configuration. Needs update permission on the configuration.

Sentiment phrase, 5 operations

create_sentiment_phraseCreate sentiment phrasePOSTAdds a sentiment phrase (a phrase with a custom sentiment weight) to a configuration. Needs update permission on the configuration.
delete_sentiment_phraseDelete sentiment phraseDELETERemoves one sentiment phrase from a configuration. Needs update permission on the configuration.
get_sentiment_phraseGet sentiment phraseGETReturns one sentiment phrase of a configuration by id.
list_sentiment_phrasesList sentiment phrasesGETLists the sentiment phrases of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_sentiment_phraseUpdate sentiment phrasePUTReplaces the definition of one sentiment phrase of a configuration. Needs update permission on the configuration.

Taxonomy, 5 operations

create_taxonomyCreate taxonomyPOSTAdds a taxonomy node (a category tree built from topics) to a configuration. Needs update permission on the configuration.
delete_taxonomyDelete taxonomyDELETERemoves one taxonomy node from a configuration. Needs update permission on the configuration.
get_taxonomyGet taxonomyGETReturns one taxonomy node of a configuration by id.
list_taxonomiesList taxonomiesGETLists the taxonomy nodes of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_taxonomyUpdate taxonomyPUTReplaces the definition of one taxonomy node of a configuration. Needs update permission on the configuration.

User entity, 5 operations

create_user_entityCreate user entityPOSTAdds a user entity (a custom named entity) to a configuration. Needs update permission on the configuration.
delete_user_entityDelete user entityDELETERemoves one user entity from a configuration. Needs update permission on the configuration.
get_user_entityGet user entityGETReturns one user entity of a configuration by id.
list_user_entitiesList user entitiesGETLists the user entities of a configuration one page at a time (data, with page, total_pages and total_elements), with optional name search and sort.
update_user_entityUpdate user entityPUTReplaces the definition of one user entity of a configuration. Needs update permission on the configuration.

Collection, 2 operations

get_processed_collectionsGet processed collectionsGETPolls for collections Semantria has finished analyzing, optionally only those of one job_id.
queue_collectionQueue collectionPOSTQueues a collection: a list of texts analyzed in relation to each other as one set. Fetch the result later with get_processed_collections.

Document, 2 operations

get_processed_documentsGet processed documentsGETPolls for documents Semantria has finished analyzing (sentiment, entities, themes, topics, categories...), optionally only those of one job_id; request_limit caps how many come back.
queue_documentsQueue documentsPOSTQueues one or more documents (each with text and optional id, tag, metadata) for analysis with a configuration; fetch the results later with get_processed_documents, using job_id to group them.

Industry pack, 2 operations

get_industry_packGet industry packGETGet detailed description of an industry pack. This action requires the FEATURE_READ permission.
list_industry_packsList industry packsGETGet a list of all industry packs. This action requires the FEATURE_READ permission.

Is primary, 2 operations

is_primary_configIs primary configGETTells whether a configuration is the account's primary (default) configuration.
set_primary_configSet primary configPOSTMakes a configuration the account's primary (default) configuration. Needs the ACCOUNT_ADMIN permission.

Language, 2 operations

get_languageGet languageGETGet a specific language supported by Semantria.
list_languagesList languagesGETGet a list of all the languages supported by Semantria.

Language template, 2 operations

get_language_templateGet language templateGETGet a detailed description of a language template.
list_language_templatesList language templatesGETGet all templates for all languages in Semantria.

Brief config, 1 operation

list_brief_configsList brief configsGETGet a brief list of all configurations for an account.

Config setting, 1 operation

list_config_settingsList config settingsGETGet a list of all the configuration settings an account can have.

Detail, 1 operation

get_account_detailsGet account detailsGETReturns the Semantria account details: name, edition, remaining document, speech and translation balances, expiration date, languages, features, industry packs and limits.

Entity type, 1 operation

list_entity_typesList entity typesGETGet a list of all enabled entity types for the configuration.

Feature, 1 operation

list_featuresList featuresGETGet a list of all the features an account can have.

Limit type, 1 operation

list_limit_typesList limit typesGETGet a list of all the limits an account can have.

Statistic, 1 operation

get_statisticsGet statisticsGETGet statistics for an account. These statistics can be filtered by intervals (hour, day, month) or using date ranges, fields, and groups.

Validate name, 1 operation

check_config_nameCheck config nameGETChecks whether a configuration name is already taken in the account, before creating or renaming a configuration.

Use Semantria from Claude Code, Cursor or Codex

Connect Semantria in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Semantria operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Semantria

Create your workspace
Sign up free. Nothing to install.
Connect Semantria once
Add your Semantria connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.