# Equinix Metal MCP > Equinix Metal MCP manages your entire infrastructure access layer through natural language prompts. You can use this connector to create or delete API keys for both users and projects, handle email addresses, and manage project invitations—all without leaving your chat window. It lets you audit, provision, and revoke access credentials instantly. ## Overview - **Category:** ship-it - **Price:** Free - **Tags:** bare-metal, infrastructure-as-code, api-management, server-provisioning, cloud-computing, access-control ## Description Managing bare-metal cloud infrastructure usually means jumping between dashboards, clicking through permission menus, and copy-pasting IDs. This MCP brings all those actions into a single conversation thread. You handle API key creation and deletion for specific projects or users. Need to add a new team email or update the default contact address? It’s here. Or maybe you just need to decline an unexpected project invitation without logging in. Instead of navigating complex portals, you simply ask your agent. Connecting this MCP via Vinkius means your AI client treats these infrastructure tasks like any other conversation—natural and immediate. You get full visibility into who has access and what they can do. ## Tools ### create_email Adds a brand new email address to your Equinix Metal account. ### create_project_api_key Generates an API key specific to one project, allowing you to limit access scope. ### create_user_api_key Creates a general API key attached to your overall user account. ### decline_invitation Blocks an incoming project invitation if you do not want to join the project. ### delete_api_key Permanently removes a user-level API key from your account. ### delete_email Removes an email address from your account settings. ### delete_user_api_key Deletes a user-level API key that was created previously. ### get_invitation Retrieves the full details of an invitation you received for a project. ### update_email Changes your primary contact email address on the account. ## Prompt Examples **Prompt:** ``` Create a new user API key named 'CI-CD-Runner' that is read-only. ``` **Response:** ``` I've created the user API key 'CI-CD-Runner'. It is set to read-only as requested. The API key ID is 'uuid-123-456'. ``` **Prompt:** ``` Add 'dev-alerts@company.com' to my account emails. ``` **Response:** ``` I have successfully added 'dev-alerts@company.com' to your account. You may need to verify it in your inbox. ``` **Prompt:** ``` Show me the details for invitation ID 'inv-998877'. ``` **Response:** ``` Fetching invitation details... This is an invite to join the 'Production-Cluster' project, sent by admin@equinix.com. It expires in 48 hours. ``` ## Capabilities ### Credential Lifecycle Management Create, delete, or view API keys for both individual users and specific projects. ### Account Communication Setup Add new contact emails to your account, update which email is the primary one, or remove old addresses. ### Invitation Workflow Control View details about pending project invitations and decline them if they aren't needed. ## Use Cases ### Revoking access for a departed contractor The security team needs to ensure a former vendor has zero remaining credentials. Instead of manually locating and deleting every key, they prompt the agent to delete_user_api_key and delete_project_api_key associated with that account ID. ### Onboarding a new microservice A developer needs a non-personal credential for automated testing. They ask the agent to create_project_api_key, specifying read-only permissions and linking it immediately to the service name. ### Handling mailbox changes The company merges departments and the default contact email needs updating. An infrastructure lead simply asks the agent to update_email with the new corporate address, bypassing manual settings clicks. ## Benefits - Audit credentials without leaving your chat. Instead of logging into the portal to check key status, you just ask your agent for details or to delete a specific user API key. - Instant credential rotation: Need to revoke a compromised key? You can use delete_user_api_key and delete_project_api_key via natural language commands, making it auditable and fast. - Simplified account administration. Don't waste time on the email settings page; you can add new contact emails using create_email or update your default address with simple instructions. - Controlled access provisioning: Whether you need a temporary key for a CI/CD run (create_project_api_key) or a general user credential, this MCP handles it in one prompt. - Project invitation control. You can check the details of an invite using get_invitation and immediately decline it with the decline_invitation tool—all done before you even remember to open your browser. ## How It Works The bottom line is that your infrastructure management becomes an extension of your natural conversation flow. 1. First, subscribe to this MCP on Vinkius and provide your Equinix Metal API Key. 2. Next, reference the required action—for example, asking the agent to create a key for a new service or add a team email. 3. Your AI client executes the necessary command and reports back the status of the change. ## Frequently Asked Questions **How do I check if I have pending project invitations with Equinix Metal MCP?** You use the get_invitation tool to view all invitation details. This lets you see which projects are inviting you and how long those invites remain active. **Can I delete a user API key using the Equinix Metal MCP?** Yes, the delete_user_api_key tool permanently removes that credential. This is useful for security audits when you need to revoke access immediately. **Which tool should I use if I only want a key for one specific project?** You must use create_project_api_key. This ensures the generated key has limited scope, which is always better security practice than using a general user-level credential. **How do I update my main contact email with Equinix Metal MCP?** Simply use the update_email tool. You provide the new address and set it as your default, bypassing the manual settings page entirely. **Can I create a read-only API key for a specific project?** Yes! Use the `create_project_api_key` tool. You can specify the `project_id`, a description, and set the `read_only` flag to true to ensure the key has restricted permissions. **How do I manage the email addresses associated with my account?** You can use `create_email` to add a new address, `update_email` to change settings like the default status, and `delete_email` to remove an address from your profile. **Is it possible to view and decline project invitations via AI?** Yes. Use `get_invitation` to see the details of a pending invite and `decline_invitation` if you do not wish to join that specific project.