create_contact
Create Contact
Creates a new contact in the Tave address book. Contacts can represent individuals or businesses and can be associated with a specific brand. Requires the **API Key (Public API V2)** authentication method.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Tave is studio management software for photographers and creative businesses. An agent connected to it can turn website inquiries into leads, look up clients, open jobs for new bookings and report on orders and payments by brand.
Create a lead from a website contact form so new inquiries land in Tave without retyping.
Create a job for a confirmed wedding or session and link it to the client contact and job type.
Search the address book for a couple or business and pull their details before a consultation call.
Summarize recent orders and payments for one brand or job type at the end of the month.
Tave uses two separate keys: the Public API V2 key for contacts, jobs, orders and payments, and the legacy New Lead API key for creating leads. Both act for the whole studio, so restrict the payment and order tools to the people who handle billing.
Sign-in options on Metorial: New Lead API (Legacy), API Key (Public API V2).
create_contact
Creates a new contact in the Tave address book. Contacts can represent individuals or businesses and can be associated with a specific brand. Requires the **API Key (Public API V2)** authentication method.
get_brands
Retrieves the list of brands configured in the Tave account. Brands represent different business identities or product lines. Useful for discovering available brands to filter contacts, jobs, and orders. Requires the **API Key (Public API V2)** authentication method.
search_contacts
Searches and retrieves contacts from the Tave address book. Can search by query string, filter by contact kind and brand, or list all contacts. Requires the **API Key (Public API V2)** authentication method.
get_orders
Retrieves orders from Tave, including both manually created orders and electronic bookings. Can filter by brand and job type. Requires the **API Key (Public API V2)** authentication method.
create_job
Creates a new job (project/booking) in Tave with associated details. Jobs link contacts to work engagements like weddings, portrait sessions, or other photography services. Can include job type, stage, event details, and role assignments. Requires the **API Key (Public API V2)** authentication method.
create_lead
Creates a new lead in Tave from an external source such as a website contact form. Requires the **New Lead API (Legacy)** authentication method with Secret Key and Studio ID. The lead can include contact details, job information, and a message. The `jobType` must exactly match a Job Type configured in Tave settings.
get_payments
Retrieves payments from Tave. Can filter by brand and job type to narrow results. Requires the **API Key (Public API V2)** authentication method.
get_jobs
Lists jobs and leads with their IDs, stages, job types, and brand IDs. Use it to find existing jobs and inspect jobs created by create_job. Requires API Key (Public API V2) authentication.
get_studio
Retrieves the studio associated with the API key, including its identity, currency, and default brand. Requires API Key (Public API V2) authentication.
get_job_types
Lists configured job types with IDs and names for creating jobs and filtering orders or payments. Requires API Key (Public API V2) authentication.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage leads, contacts, jobs, orders, and payments for photography and creative studio businesses. Create leads from external sources such as website forms. Create, search, and retrieve contacts with custom fields. Create and manage jobs with job types, stages, roles, event dates, and custom fields. Track orders and bookings including electronic client bookings. Monitor payments by brand and job type. Retrieve and manage brand configurations. Trigger automated workflows on contact creation, order booking, and payment events. Send outbound web requests from workflow automations to external services.
Common questions about connecting Tave to AI agents with Metorial.