# How to connect Perplexityai to Muse

```json
{
  "title": "How to connect Perplexityai to Muse",
  "toolkit": "Perplexityai",
  "toolkit_slug": "perplexityai",
  "framework": "Muse",
  "framework_slug": "muse",
  "url": "https://composio.dev/toolkits/perplexityai/framework/muse",
  "markdown_url": "https://composio.dev/toolkits/perplexityai/framework/muse.md",
  "updated_at": "2026-10-04T16:35:59.625Z"
}
```

## Introduction

Muse is Meta's AI assistant. It can connect to outside tools through custom connectors, which use the Model Context Protocol (MCP).
This guide explains how to connect Perplexityai to Muse using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a custom connector once, then ask Muse to work with Perplexityai in plain language.

## Also integrate Perplexityai with

- [Claude Code](https://composio.dev/toolkits/perplexityai/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/perplexityai/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/perplexityai/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/perplexityai/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/perplexityai/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/perplexityai/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/perplexityai/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/perplexityai/framework/grok-bot)
- [Codex](https://composio.dev/toolkits/perplexityai/framework/codex)
- [Kimi Code](https://composio.dev/toolkits/perplexityai/framework/kimi)
- [Grok Build](https://composio.dev/toolkits/perplexityai/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/perplexityai/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/perplexityai/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/perplexityai/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/perplexityai/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/perplexityai/framework/atomic-agent)
- [CLI](https://composio.dev/toolkits/perplexityai/framework/cli)
- [Google ADK](https://composio.dev/toolkits/perplexityai/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/perplexityai/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/perplexityai/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/perplexityai/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/perplexityai/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/perplexityai/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/perplexityai/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/perplexityai/framework/autogen)

## TL;DR

- Cross-app workflows across 1,500+ apps from a single plugin layer.
- On-demand tool loading so Muse only loads the tools needed for the current task.
- Programmatic tool calling through a remote workbench for complex, multi-step workflows.
- Multi-account support so users can connect and switch between multiple accounts for the same app.
- Shared account access so teams or agents can work through common business accounts and service connections.
- Managed authentication with OAuth handling, credential storage, and token refresh managed by Composio.
- Safer credential handling so app credentials stay outside the model context and tool responses.
- User-level account isolation so actions run against the correct connected account instead of mixing user access.

## Connect Perplexityai to Muse

### Connecting Perplexityai to Muse
You add Composio to Muse once as a custom connector, then connect Perplexityai from the chat.

## What is the Perplexityai MCP server, and what's possible with it?

The Perplexity AI MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Perplexity AI account. It provides structured and secure access to Perplexity AI's conversational models, web search, embeddings, and agent execution, so your agent can search the web, generate responses, run Perplexity agents, create embeddings, and manage asynchronous chat requests on your behalf.
- Web search: Have your agent search the web and return relevant results for research, fact-finding, or current topics.
- Conversational responses: Let the agent use Perplexity Sonar models to answer questions, explain topics, and generate human-like text.
- Asynchronous chat tasks: Direct your agent to start longer chat requests, check their progress, and review previously submitted requests.
- Perplexity agent execution: Instruct your agent to run a Perplexity agent for tasks that need an agent-generated response.
- Text embeddings and model discovery: Have your agent create standard or contextualized embeddings for text and view the Perplexity models available to your account.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `PERPLEXITYAI_CREATE_ASYNC_CHAT_COMPLETION` | Create Async Chat Completion | Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks. Returns immediately with a request ID that can be polled using the Get Async Chat Completion action. Only the 'sonar-deep-research' model is supported for async processing. Async jobs have a 7-day TTL. Deep research generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Use the idempotency_key to prevent duplicate submissions. Poll with Get Async Chat Completion using the returned request ID to retrieve results when status is COMPLETED. |
| `PERPLEXITYAI_CREATE_CHAT_COMPLETION` | Create Chat Completion | Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations. Supports multiple Sonar models optimized for different use cases: - sonar: Fast, cost-effective for simple queries - sonar-pro: Enhanced quality for complex questions - sonar-reasoning-pro: Chain-of-thought reasoning with blocks - sonar-deep-research: Exhaustive multi-source research (generates very long responses, 10K+ words; prefer the async endpoint for this model) Features: web search grounding, citations, images, structured JSON output, search filtering by domain/date/language/recency, and streaming. Important constraints: - search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, etc.) are mutually exclusive. Use one or the other, not both. - Messages with the 'tool' role must alternate with 'assistant' messages. A valid pattern is: system -> user -> assistant -> tool -> user. - The 'stop' parameter is not currently supported by the API. |
| `PERPLEXITYAI_CREATE_CONTEXTUALIZED_EMBEDDINGS` | Create Contextualized Embeddings | Create Contextualized Embeddings (POST /v1/contextualizedembeddings). Generates document-aware embeddings where chunks from the same document share context. Unlike standard embeddings, these recognize sequential relationships within documents, improving retrieval quality. Models: pplx-embed-context-v1-0.6b (1024 dims) and pplx-embed-context-v1-4b (2560 dims). Both support Matryoshka dimension reduction and INT8/binary quantization. |
| `PERPLEXITYAI_CREATE_EMBEDDINGS` | CreateEmbeddings | Generate vector embeddings for independent texts (queries, sentences, documents). This action takes one or more input texts and generates vector embeddings using Perplexity AI's embedding models. Embeddings are useful for semantic search, similarity matching, and machine learning downstream tasks. Supported models: - pplx-embed-v1-0.6b: Smaller, faster model (1024 dimensions) - pplx-embed-v1-4b: Larger, more accurate model (2560 dimensions) The output embeddings are base64-encoded for efficient transmission. Use the dimensions parameter to reduce embedding size for faster processing when full precision is not required (Matryoshka representation). |
| `PERPLEXITYAI_EXECUTE_AGENT` | Execute Agent | Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling), reasoning, and multi-model support. Streaming is not supported by this action. At least one of 'model', 'models', or 'preset' must be provided. Available presets: 'fast-search', 'pro-search', 'deep-research'. The 'deep-research' preset generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Available models include Perplexity Sonar, OpenAI, Anthropic, Google, xAI, and NVIDIA models at direct provider rates. Use the List Models action to see available model identifiers. |
| `PERPLEXITYAI_GET_ASYNC_CHAT_COMPLETION` | Get Async Chat Completion | Get Async Chat Completion (GET /v1/async/sonar/{id}). Retrieves the result of an asynchronous chat completion request by its ID. Use this to poll for the result after creating an async job. The response includes the status and, when completed, the full completion. |
| `PERPLEXITYAI_LIST_ASYNC_CHAT_COMPLETIONS` | List Async Chat Completions | List Async Chat Completions (GET /v1/async/sonar). Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, and failed async jobs. |
| `PERPLEXITYAI_LIST_MODELS` | List Models | List Models (GET /v1/models). Lists models available for the Agent API. Returns model identifiers that can be used with the Agent endpoint. The response follows the OpenAI List Models format for compatibility. This is a public endpoint that does not require authentication. |
| `PERPLEXITYAI_SEARCH` | Perplexity Search (Raw Results) | Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing. Faster and cheaper than chat completions when you need raw results. Supports filtering by domain, date, language, country, and recency. Max 20 results per request. Important: search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, last_updated_after_filter, last_updated_before_filter) are mutually exclusive. Use one or the other, not both. |

## Supported Triggers

None listed.

## Troubleshooting

### 1. Why doesn't Muse show a button to add my API key?

Muse shows the button only when you ask it to open the secure credentials store.
- Start a new chat.
- Send the message from step 1 exactly as written.
- If Muse asks for the key in the chat, do not paste it. Ask Muse to open the secure credentials store.

### 2. Why does the Composio connection fail after I add my API key?

The key or the connector settings are not correct.
- Copy the full key from the Composio dashboard. It starts with ck_.
- Make sure the URL is https://connect.composio.dev/mcp and the header is x-consumer-api-key.
- Remove the Composio connector in Muse settings, then do steps 1 to 3 again.

### 3. Why doesn't Muse use the Composio tools for Perplexityai?

Muse may not pick the Composio connector for the request.
- Ask Muse to list its Composio tools.
- Name Composio and Perplexityai in your request, for example: Use Composio to connect to Perplexityai.
- If it still does not work, start a new chat and try again.

### 4. Why does Muse ask me to connect Perplexityai again?

Your Perplexityai connection expired or was removed.
- Open the link Muse gives you and sign in to Perplexityai again.
- Check that the Perplexityai connection shows as ACTIVE in the Composio dashboard.

### 5. What do I do if I pasted my API key into the chat?

Treat the key as exposed.
- Create a new API key in the Composio dashboard and delete the old one.
- Add the new key in Muse's secure credentials store, not in the chat.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, Muse can access the Perplexityai MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### Way Forward
Now that Perplexityai is connected, extend your setup by connecting the other apps you already use every day, so Muse can run true cross-app workflows end to end.
- Connect Calendar to turn threads into scheduled meetings automatically.
- Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
- Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
- Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, Muse can coordinate multiple tools safely and reliably in one conversation.

## How to build Perplexityai MCP Agent with another framework

- [Claude Code](https://composio.dev/toolkits/perplexityai/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/perplexityai/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/perplexityai/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/perplexityai/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/perplexityai/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/perplexityai/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/perplexityai/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/perplexityai/framework/grok-bot)
- [Codex](https://composio.dev/toolkits/perplexityai/framework/codex)
- [Kimi Code](https://composio.dev/toolkits/perplexityai/framework/kimi)
- [Grok Build](https://composio.dev/toolkits/perplexityai/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/perplexityai/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/perplexityai/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/perplexityai/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/perplexityai/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/perplexityai/framework/atomic-agent)
- [CLI](https://composio.dev/toolkits/perplexityai/framework/cli)
- [Google ADK](https://composio.dev/toolkits/perplexityai/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/perplexityai/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/perplexityai/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/perplexityai/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/perplexityai/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/perplexityai/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/perplexityai/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/perplexityai/framework/autogen)

## Related Toolkits

- [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
- [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.
- [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
- [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows.
- [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application.
- [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities.
- [AltTextLab](https://composio.dev/toolkits/alt_text_lab) - AltTextLab is an AI service that generates accessible, SEO-aware alt text for images. It helps teams make image content easier to understand, index, and publish.
- [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization.
- [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications.
- [Apiframe](https://composio.dev/toolkits/apiframe) - Apiframe is an API platform for generating and managing AI images, videos, music, uploads, assets, jobs, and custom LoRAs. It gives developers one clean API for creative AI workflows without juggling multiple model providers.
- [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations.
- [Arize AX](https://composio.dev/toolkits/arize_ax) - Arize AX is an AI engineering platform for tracing, evaluating, and improving AI applications. Use it to debug LLM behavior, compare experiments, and improve production AI quality.
- [Artificial Analysis](https://composio.dev/toolkits/artificial_analysis) - Artificial Analysis is an independent benchmarking platform for AI models and API providers. Use it to compare model intelligence, coding, math, pricing, latency, throughput, and arena rankings.
- [AssemblyAI](https://composio.dev/toolkits/assemblyai) - AssemblyAI is a speech-to-text and audio intelligence API for uploaded or hosted media. Use it to turn audio and video into accurate transcripts, summaries, and insights.
- [Avoma](https://composio.dev/toolkits/avoma) - Avoma is an AI meeting assistant for recording, transcribing, analyzing, and managing meetings, calls, notes, scorecards, and conversation intelligence. It helps teams turn conversations into searchable notes, follow-ups, coaching insights, and revenue intelligence.
- [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient.
- [Bland AI](https://composio.dev/toolkits/bland_ai) - Bland AI is a conversational AI platform for building voice agents, phone calls, messaging, and communication workflows. Use it to automate calling, evaluate conversations, and run voice operations at scale.
- [Botbaba](https://composio.dev/toolkits/botbaba) - Botbaba is a platform for building, managing, and deploying conversational AI chatbots across messaging channels. It streamlines chatbot automation, making it easier to integrate AI into customer interactions.
- [BotMape](https://composio.dev/toolkits/botmape) - BotMape is an API platform for building AI agents, knowledge bases, conversations, and messages. Use it to manage agent workflows and track usage analytics from one place.
- [Botpress](https://composio.dev/toolkits/botpress) - Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences.

## Frequently Asked Questions

### Does Muse support MCP?

Yes. Muse supports custom connectors that use the Model Context Protocol (MCP). Composio connects as one custom connector over remote streamable HTTP at https://connect.composio.dev/mcp, and gives Muse access to Perplexityai and 1,500+ other apps.

### Where do I get the API key for the Composio connector?

Copy it from the Composio dashboard. It starts with ck_. Enter it only in Muse's secure credentials store, never in the chat.

### Can I connect more than one Perplexityai account to Muse?

Yes. Composio supports multiple connected accounts for the same app. Give each Perplexityai connection a name, such as work or personal, and tell Muse which one to use.

### How safe is my Perplexityai data with Composio?

Tokens, keys, and configuration are encrypted at rest and in transit. Your Composio API key stays in Muse's secure credentials store, not in the chat or the model context. Composio is SOC 2 Type 2 compliant.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)