# Thesaurus API MCP > Thesaurus API connects your AI agent directly to a specialized vocabulary database. It lets you programmatically retrieve synonyms and antonyms for any word, making it ideal for linguistic research, content auditing, or style guide enforcement. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** linguistics, synonyms, antonyms, writing-assistant, vocabulary, text-analysis ## Description This API hooks your AI agent up to a massive vocabulary database. It lets you pull synonyms and antonyms for any word programmatically, making it perfect for linguistic research or enforcing strict style guides within generated content. You don't have to open a dictionary website; your agent handles the lookup directly. First off, when you integrate this server, you should check its operational status using `check_api_status`. Running that function gives you a quick health check. It confirms whether the entire thesaurus service is online and ready to accept requests right now. You'll know immediately if there's an issue before your agent tries to process content. The core capability comes from `get_synonyms_antonyms`. This tool accepts one specific word as input. When you run it, your agent pulls back structured lists of alternative words (synonyms) and opposite meanings (antonyms). It doesn't just suggest random alternatives; it gives you the semantic relationships between those words. You can pass a single target word into this function to get multiple sets of related vocabulary. The output is always organized, making it simple for your agent to parse. For example, if you feed it a noun, it will return synonyms and antonyms relevant to that part of speech, allowing your content audit to stay highly accurate. If you're dealing with large volumes of text—say, auditing thousands of product descriptions or analyzing academic papers—this tool lets your agent conduct full vocabulary checks on the fly. You can use it to track how often certain concepts are discussed using different phrasing. This helps you maintain a consistent tone while keeping your copy from sounding repetitive. When you're revising content and need to swap out weak verbs or overly common adjectives, this API is what you use. Your agent doesn't just pick the first synonym it finds; it provides distinct lists of alternatives so you can choose the word that fits the context best. The system separates synonyms from antonyms cleanly, giving you both options in one go. For instance, if your writing requires a strong action verb, `get_synonyms_antonyms` will give you multiple replacements that carry similar weight or emotional impact. If you need to ensure the tone isn't drifting into hyperbole, checking for antonyms helps your agent flag overly extreme claims. This mechanism lets you enforce specific stylistic boundaries across all content it touches. When developing sophisticated agents, you might want them to perform a full linguistic audit. You feed in a document chunk, and instead of just processing the text, your agent hits this API for every key word. It builds an internal map of semantic density—you see exactly what words are clustered together and how many different ways that concept can be articulated without changing meaning. This process is critical for quality control. You're not just checking spelling; you're verifying the *breadth* of vocabulary available to your content. It lets your agent understand the full range of a word's usage, ensuring your final output feels polished and highly professional. When combined with other tools in your stack, this thesaurus lookup becomes an absolute requirement for any AI client doing serious writing or data analysis work. Remember that you can chain these functions together: first, confirming service status using `check_api_status`, then feeding the necessary words into `get_synonyms_antonyms` to generate a comprehensive list of options. The structured nature of the output means your agent never has to guess what data it's getting back; it always expects clean lists for both synonyms and opposites. ## Tools ### check_api_status Checks if the Thesaurus service is operational and ready to accept requests. ### get_synonyms_antonyms Retrieves lists of synonyms or antonyms for a specific word you provide. ## Prompt Examples **Prompt:** ``` Find synonyms for the word 'beautiful' using Thesaurus API. ``` **Response:** ``` I've retrieved the synonyms for 'beautiful'! Notable entries include 'attractive', 'lovely', and 'stunning'. Would you like the antonyms or another word audit? ``` **Prompt:** ``` What is the antonym of 'success'? ``` **Response:** ``` I've identified the antonyms for 'success'! The primary marker is 'failure'. I can provide the full list of synonyms if you'd like to maintain stylistic control over your content. ``` **Prompt:** ``` Check the status of the Thesaurus service. ``` **Response:** ``` I've checked the status of the APIVerve Thesaurus service! It is currently identified as 'active' and fully operational. I can assist you with vocabulary retrieval for your writing projects. ``` ## Capabilities ### Get Synonyms/Antonyms Passes a word into the agent, which retrieves lists of alternative words (synonyms) and opposite meanings (antonyms). ### Check Service Status Runs a simple health check to confirm that the thesaurus service is currently operational. ## Use Cases ### Drafting a Technical Manual A technical writer drafts a section and realizes they used the word 'solve' five times. They prompt their agent: 'Audit synonyms for solve.' The Thesaurus API returns alternatives like 'resolve', 'rectify', or 'address,' letting them pick one that fits the required formality. ### Reviewing Marketing Copy A content strategist reviews a landing page full of bland adjectives. They run `get_synonyms_antonyms` on words like 'good' or 'great.' The agent pulls out more impactful options ('stellar,' 'premium'), immediately upgrading the copy. ### Analyzing Academic Texts A student is writing a literature review and needs to confirm if two concepts are semantically related. They ask the Thesaurus API for word relationships, getting confirmation that their chosen terms have overlapping academic meanings. ### Testing Style Guide Compliance An operations lead builds a prompt that checks all output against a core list of forbidden words. The agent uses `get_synonyms_antonyms` to suggest approved replacements every time the banned word appears. ## Benefits - Audits your writing instantly. Instead of guessing, you let the Thesaurus API pull high-resolution synonyms and antonyms for any word, ensuring precise language every time. - Maintains consistent tone across long documents. Use `get_synonyms_antonyms` to spot repetitive vocabulary patterns and swap out weak words with stronger alternatives automatically. - Accelerates research drafting. Academic researchers can run full semantic audits on a concept, validating the breadth of word usage without manual dictionary lookups. - Reduces content drift. Content teams use this API to enforce style guides across multiple writers, guaranteeing that terms like 'utilize' are replaced with approved alternatives. - Works right inside your workflow. Because it’s an MCP server, you don't need to switch windows or copy/paste; just ask your agent. ## How It Works The bottom line is: it turns complex dictionary research into a simple conversational query for your AI client. 1. Subscribe to the server and enter your APIVerve key. 2. Ask your AI client (like Cursor or Claude) to run a specific tool, like `get_synonyms_antonyms`. 3. The agent sends the word data through MCP, and you get back structured lists of related words. ## Frequently Asked Questions **How do I find my APIVerve Key?** Log in to your [**APIVerve dashboard**](https://apiverve.com/), and you will find your API Key in your account settings. Copy and paste it below. **Does it support multiple languages?** This specific API focuses on English synonyms and antonyms metadata. **Can the agent show both synonyms and antonyms?** Yes. The `get_synonyms_antonyms` tool retrieves both lists for the specified word where available in the database. **What should I run first when setting up my agent with `check_api_status`?** You should always run `check_api_status` immediately after setup. This verifies that your AI client has successfully connected to the Thesaurus service and confirms it's fully operational before you start writing. **What happens if I use `get_synonyms_antonyms` with a misspelled word?** The API will return an error or an empty data set. Always double-check your spelling and ensure the input word is correctly formed before querying for synonyms. **Does the Thesaurus API handle technical jargon or specialized vocabulary?** It works best with common English words. While it can process some domain-specific terms, highly niche jargon might yield limited or no results; you may need to use a different type of database for that. **What is the expected data format when I call `get_synonyms_antonyms`?** The tool returns structured JSON. It provides separate lists for synonyms and antonyms, clearly categorized by word relation and type to keep your agent's output clean. **Are there rate limits when I call `get_synonyms_antonyms` repeatedly?** The service enforces reasonable usage limits. If you send too many requests in a short period, the API will return a specific HTTP error code telling you exactly how long to wait before trying again.