Documentation

MCP Connections

MCP Connections

Promptmark can now talk to other tools. Connect to any MCP-compatible server, browse its capabilities, and use those tools directly in conversations, playbooks, and tests – no glue code required.

What’s new

  • Connect to any MCP server – Add connections to external tool servers like Civic Hub, internal APIs, or any service that speaks MCP. Each connection stores its own credentials and health status.
  • Flexible authentication – Choose the auth method that fits your server: bearer token, API key, OAuth, or custom headers. Promptmark handles token refresh and reconnection automatically.
  • Civic Auth integration – First-class support for Civic’s OAuth flow. Tools that require user authorization show a one-click connect button; Promptmark polls for completion and picks up the token seamlessly.
  • Tool discovery – Once connected, Promptmark fetches the server’s tool catalog automatically. Browse tools by name and description, mark favorites for quick access, and refresh the catalog when the server updates.
  • Manual tool execution – Run any discovered tool directly from its detail page. Fill in the input schema, execute, and watch results stream back in real time.
  • AI-powered tool use – Attach tools to conversations and playbooks and let the AI call them as needed. The model sees tool descriptions in its context and decides when to invoke them – you stay in control of which tools are available.
  • Tool picker – A searchable picker lets you attach tools to prompts, conversations, and tests. Bulk select or clear tools per connection, with “+N more” overflow chips when many are attached.
  • Anthropic native tools – Web search and code execution are available for Anthropic models directly in the tool picker, no external server needed.

For API integrators

Ten new MCP tools for managing connections and discovered tools:

Tool Description
list_mcp_connections List all configured MCP connections
get_mcp_connection Get connection details and status
create_mcp_connection Add a new MCP server connection with auth config
update_mcp_connection Update connection settings or credentials
delete_mcp_connection Remove a connection and its discovered tools
test_mcp_connection Test connectivity and auth against a server
browse_mcp_tools Browse tools discovered from a connection
refresh_mcp_tools Re-fetch the tool catalog from a connected server
get_mcp_connection_history View connection event history
toggle_mcp_tool_favorite Mark or unmark a discovered tool as a favorite

Promptmark now has 74 MCP tools across 12 categories. Everything you can do in the web UI, you can do through an AI assistant.

Info
Tool attachments work across the platform. Attach tools to a conversation for interactive use, to a playbook step for automated workflows, or to a test for validating prompt behavior with live tool access.