{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Usage Guide - Outreach MCP | Outreach","description":"Outreach extensibility development and documentation portal","siteUrl":"https://developers.outreach.io","keywords":"outreach developer portal, api documentation, api reference docs, sdk documentation","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"usage-guide","__idx":0},"children":["Usage Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn how to wire the Outreach MCP server into your agent runtime and build effective workflows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-wire-the-mcp-server-into-your-agent-runtime","__idx":1},"children":["1. Wire the MCP server into your agent runtime"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most agent frameworks (Claude, MCP clients, custom orchestrators) accept an MCP server URL plus auth. Once connected, the tools above are auto-discovered via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tools/list"]},". You don't list them manually."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-let-the-agent-pick-the-tool","__idx":2},"children":["2. Let the agent pick the tool"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tools are described with schemas the model reads at runtime. Your job is the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["prompt"]},", not the API call. Examples:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"User asks..."},"children":["User asks..."]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Agent calls..."},"children":["Agent calls..."]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Find CROs at Contoso\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prospect_search"]}," with title filter"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"What's the status of the Acme deal?\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opportunity_search"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opportunity_get_by_id"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Create a prospect for Sarah Chen at Geometric Corp\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prospect_create"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Add her to the outbound sequence\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sequence_search"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sequence_add_prospects"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"Show me recent meetings with Initech\""]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kaia_meeting_search"]}," with account filter"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-chain-tools-for-multi-step-workflows","__idx":3},"children":["3. Chain tools for multi-step workflows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The agent does this automatically. For \"Add Sarah Chen to Executive Outbound Touch\":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prospect_create"]}," → returns prospect ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sequence_search"]}," (name = \"Executive Outbound Touch\") → returns sequence ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sequence_add_prospects"]}," (both IDs) → returns batch status"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No glue code on the developer side."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-handle-write-operations-carefully","__idx":4},"children":["4. Handle write operations carefully"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Writes are real. Build in confirmation flows, audit logging, and rate limits in your agent layer. The MCP server does not throttle or undo. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destructiveHint: true"]}," annotations to drive your confirmation UX."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-tool-patterns","__idx":5},"children":["Common Tool Patterns"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search--fetch--act","__idx":6},"children":["Search → Fetch → Act"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"account_search → account_get_by_id → account_answer_question\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most exploration workflows follow this shape."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create--enroll--verify","__idx":7},"children":["Create → Enroll → Verify"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"prospect_create → sequence_add_prospects → sequence_state_search\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full prospect onboarding lifecycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"discover-schema--create","__idx":8},"children":["Discover Schema → Create"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"input_fields_fetch → prospect_create\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use when fields differ across orgs (custom fields, required validations)."]}]},"headings":[{"value":"Usage Guide","id":"usage-guide","depth":1},{"value":"1. Wire the MCP server into your agent runtime","id":"1-wire-the-mcp-server-into-your-agent-runtime","depth":2},{"value":"2. Let the agent pick the tool","id":"2-let-the-agent-pick-the-tool","depth":2},{"value":"3. Chain tools for multi-step workflows","id":"3-chain-tools-for-multi-step-workflows","depth":2},{"value":"4. Handle write operations carefully","id":"4-handle-write-operations-carefully","depth":2},{"value":"Common Tool Patterns","id":"common-tool-patterns","depth":2},{"value":"Search → Fetch → Act","id":"search--fetch--act","depth":3},{"value":"Create → Enroll → Verify","id":"create--enroll--verify","depth":3},{"value":"Discover Schema → Create","id":"discover-schema--create","depth":3}],"frontmatter":{"seo":{"title":"Usage Guide - Outreach MCP | Outreach"}},"lastModified":"2026-05-26T08:58:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server/usage-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}